@lark-apaas/miaoda-cli 0.1.2-alpha.45db14c → 0.1.2-alpha.4e370b6

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

@@ -1,208 +0,0 @@
-"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.handleObservabilityMetric = handleObservabilityMetric;
-const api = __importStar(require("../../../api/index"));
-const output_1 = require("../../../utils/output");
-const shared_1 = require("../../../cli/commands/shared");
-const helpers_1 = require("./helpers");
-/**
- * PRD <metric-name> + --series → 服务端 metric name → 表头列名（=对应 --series 取值）。
- *
- * - 缺省 --series 时返回该 cliName 下所有相关线。
- * - latency / requests 的 error 线 v1.0.122 起由独立 metric 提供（不再 is_error filter）。
- *
- * 表头标签直接用 --series 名（"total"/"error"/"p50"/"p99"）；单一指标则用 cliName。
- */
-const METRIC_LABELS = {
-    cpu: { cpu_usage: "cpu" },
-    memory: { mem_usage: "memory" },
-    requests: {
-        client_api_request_count: "total",
-        client_api_request_error_count: "error",
-    },
-    latency: {
-        client_api_request_latency_p50: "p50",
-        client_api_request_latency_p99: "p99",
-    },
-};
-/** miaoda observability metric <metric-name> */
-async function handleObservabilityMetric(opts) {
-    if (!opts.metricName)
-        (0, shared_1.failArgs)("<metric-name> 必填");
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
-    const { metricNames, labelByMetric, extraFilters } = resolveMetricSelection(opts.metricName, opts.series);
-    const filters = (0, helpers_1.buildFieldFilters)([
-        { key: "referer_path", value: opts.page ? (0, helpers_1.eqFilter)(opts.page) : undefined },
-        { key: "api", value: opts.api ? (0, helpers_1.eqFilter)(opts.api) : undefined },
-        ...extraFilters,
-    ]);
-    // since/until 直接以秒透传到 BAM；当前未做桶对齐（如需开启把 until
-    // 用 ceilMsToBucket(untilMs, downSample as GranularityBucket) 包一层即可）。
-    const downSample = opts.downSample ?? "1h";
-    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 req = {
-        appID,
-        appEnv: "runtime",
-        metricNames,
-        startTimestamp: (0, helpers_1.msToSec)(sinceMs),
-        endTimestamp: (0, helpers_1.msToSec)(untilMs),
-        filters,
-        downSample,
-        needPackLackPoint: false,
-    };
-    const resp = await api.observability.queryMetricsData(req);
-    // requests 的 count / error_count：
-    //   - BAM 在该时间点无数据时会传 null，或者 values 里干脆缺 key
-    //   - CLI 按"请求过的 metricNames"逐一兜底为 0，让"没有请求"和"没有数据"
-    //     在表格 / JSON 里都显式呈现成 0，避免空格 / 缺字段被误解为缺失
-    // latency / cpu / memory 不做这个兜底——p50 没数据 ≠ 延迟为 0。
-    if (opts.metricName === "requests") {
-        fillRequestedMetricsWithZero(resp, metricNames);
-    }
-    emitMetricsResponse(resp, labelByMetric);
-}
-/**
- * 按"客户端请求过的 metricNames"兜底缺失/为 null 的值为 0；不去动 BAM 多返回的
- * 其他字段（防御性，避免误改不属于本次查询的数据）。
- */
-function fillRequestedMetricsWithZero(resp, requestedMetricNames) {
-    for (const point of resp.points ?? []) {
-        for (const name of requestedMetricNames) {
-            point.values[name] ??= 0;
-        }
-    }
-}
-// ── 渲染 ─────────
-//
-// BAM v1.0.123 起返回 points: [{timestamp, dimensions, values: {metricName: v}}]——
-// 服务端已把多 metric 合并到同 timestamp 的 row，下游直接平铺即可。
-// JSON 模式：原样透传 points（保留 BAM 原 metricName 作为 values 的 key）。
-// Pretty 模式：把 values 里的 metricName 重命名成 CLI label（p50/p99/total 等），
-//   再走 buildPivotSchema 渲染。
-function emitMetricsResponse(resp, labelByMetric) {
-    const points = resp.points ?? [];
-    // metric 不分页，但仍补齐 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;
-    }
-    const hasLatency = Object.keys(labelByMetric).some((n) => n.includes("latency"));
-    (0, output_1.emit)({ data: rows, next_cursor: null, has_more: false }, buildPivotSchema(seriesLabels, hasLatency));
-}
-function renameAndSort(points, labelByMetric) {
-    // 列顺序按 labelByMetric 声明顺序，避免 BAM 返回顺序波动影响表头
-    const seriesLabels = Object.values(labelByMetric);
-    // TODO: 当 dimensions 非空（groupBy 多 series）时，把 dimensions 也并入 row
-    const rows = points.map((point) => {
-        const row = { timestamp: point.timestamp };
-        for (const [metricName, value] of Object.entries(point.values)) {
-            const label = labelByMetric[metricName] ?? metricName;
-            row[label] = value;
-        }
-        return row;
-    });
-    // 按时间倒序，与 log/trace 的"最新在前"风格一致
-    rows.sort((a, b) => b.timestamp - a.timestamp);
-    return { rows, seriesLabels };
-}
-function buildPivotSchema(seriesLabels, hasLatency) {
-    const valueFormat = hasLatency ? output_1.fmt.durationMs() : undefined;
-    return {
-        columns: [
-            { key: "timestamp", label: "time", format: output_1.fmt.sec() },
-            ...seriesLabels.map((label) => ({
-                key: label,
-                label,
-                ...(valueFormat ? { format: valueFormat } : {}),
-            })),
-        ],
-        strict: true,
-    };
-}
-/**
- * 解析 <metric-name> + --series 的组合：决定最终 metricNames、表头 label 映射、附加过滤。
- *
- * label 直接用 --series 取值（"total"/"error"/"p50"/"p99"）；单一指标 cliName 也作为 label。
- */
-function resolveMetricSelection(cliName, series) {
-    const extras = [];
-    if (cliName === "latency") {
-        if (series === "p99") {
-            return single("client_api_request_latency_p99", "p99", extras);
-        }
-        if (series === "p50") {
-            return single("client_api_request_latency_p50", "p50", extras);
-        }
-        return all(METRIC_LABELS.latency, extras);
-    }
-    if (cliName === "requests") {
-        // v1.0.122 起 error 线由独立 metric 提供，不再走 is_error filter
-        if (series === "total") {
-            return single("client_api_request_count", "total", extras);
-        }
-        if (series === "error") {
-            return single("client_api_request_error_count", "error", extras);
-        }
-        return all(METRIC_LABELS.requests, extras);
-    }
-    if (cliName === "cpu")
-        return all(METRIC_LABELS.cpu, extras);
-    if (cliName === "memory")
-        return all(METRIC_LABELS.memory, extras);
-    // 兜底：CLI 名直接作为 metric name + label
-    return single(cliName, cliName, extras);
-}
-function single(metricName, label, extras) {
-    return {
-        metricNames: [metricName],
-        labelByMetric: { [metricName]: label },
-        extraFilters: extras,
-    };
-}
-function all(labelByMetric, extras) {
-    return {
-        metricNames: Object.keys(labelByMetric),
-        labelByMetric,
-        extraFilters: extras,
-    };
-}

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

@@ -1,102 +0,0 @@
-"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.handleObservabilityTraceList = handleObservabilityTraceList;
-exports.handleObservabilityTraceGet = handleObservabilityTraceGet;
-const api = __importStar(require("../../../api/index"));
-const output_1 = require("../../../utils/output");
-const shared_1 = require("../../../cli/commands/shared");
-const index_1 = require("../../../api/observability/index");
-const helpers_1 = require("./helpers");
-/** miaoda observability trace list */
-async function handleObservabilityTraceList(opts) {
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
-    const appEnv = "runtime";
-    const limit = (0, helpers_1.validateLimit)(opts.limit ?? 50);
-    // 过滤 key 对齐 BAM Span 字段名：
-    //   - 顶层字段：traceID（注意大小写）
-    //   - attributes 业务字段：user_id（snake_case）
-    //   - 入口 span：BAM 没有 entrySpanName fieldFilter，统一走 fuzzyFilter（trace endpoint
-    //     默认作用于 span name），所以 --root-span 不进 fieldFilters
-    const fieldFilters = (0, helpers_1.buildFieldFilters)([
-        { key: "trace_id", value: opts.traceId ? (0, helpers_1.eqFilter)(opts.traceId) : undefined },
-        { key: "user_id", value: opts.userId ? (0, helpers_1.eqFilter)(opts.userId, "i64") : 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: opts.rootSpan ? (0, helpers_1.fuzzyFilter)(opts.rootSpan) : undefined,
-    };
-    const resp = await api.observability.searchTraces(req);
-    emitSearchTracesResponse(resp);
-}
-function emitSearchTracesResponse(resp) {
-    (0, output_1.emit)({
-        data: resp.spans ?? [],
-        next_cursor: resp.hasMore ? resp.nextPageToken : null,
-        has_more: resp.hasMore,
-    }, index_1.spanSchema);
-}
-/** miaoda observability trace get <trace-id> */
-async function handleObservabilityTraceGet(opts) {
-    if (!opts.traceId)
-        (0, shared_1.failArgs)("<trace-id> 必填");
-    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
-    const appEnv = "runtime";
-    const resp = await api.observability.getTraces({
-        appID,
-        appEnv,
-        traceID: opts.traceId,
-        withLogSeverityCount: opts.withLogSeverityCount,
-    });
-    emitGetTraceResponse(resp);
-}
-function emitGetTraceResponse(resp) {
-    // JSON 模式：保持单条信封语义，便于下游一次解析
-    if ((0, output_1.isJsonMode)()) {
-        (0, output_1.emit)({
-            data: { spans: resp.spans ?? [], isBreak: resp.isBreak },
-        });
-        return;
-    }
-    // Pretty 模式：先打头部 key-value（断链状态等元信息），再按 spanSchema 渲染主表
-    (0, output_1.emit)({ data: { isBreak: resp.isBreak } });
-    (0, output_1.emit)({ data: resp.spans ?? [] }, index_1.spanSchema);
-}

package/dist/utils/devops-error.js

@@ -1,28 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapDevopsError = mapDevopsError;
-const error_1 = require("./error");
-/**
- * 把 BAM lark.apaas.devops 的业务码（数字字符串）映射成 CLI 错误码。
- * 来源：服务端技术方案 wiki L7P8wlNQ5iyShLkxzlOcCo8LnTg「业务错误码映射表」。
- *
- * 放在 utils 下而不是某个具体 api 域里：app / deploy 都跑在 lark.apaas.devops
- * 这同一 PSM，业务码命名空间也共享；boundaries 规则又禁止 api 域间互引。
- */
-function mapDevopsError(bizCode, message) {
-    switch (bizCode) {
-        case "400002577":
-        case "400002569":
-            return new error_1.AppError("APP_NOT_FOUND", message, {
-                next_actions: ["Run `miaoda app list` to see available apps"],
-            });
-        case "400002579":
-            return new error_1.AppError("APP_PERMISSION_DENIED", message);
-        case "400002575":
-            return new error_1.AppError("INVALID_ARG_VALUE", message, {
-                next_actions: ["缩短 --name / --description 后重试（后端有长度限制）"],
-            });
-        default:
-            return undefined;
-    }
-}

package/dist/utils/git.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCurrentGitBranch = getCurrentGitBranch;
-const node_child_process_1 = require("node:child_process");
-/**
- * 读取 cwd 所在仓库的当前分支名。
- *
- * 不在 git 仓库、git 不可用、或处于 detached HEAD 时返回 undefined，
- * 让调用方决定回退策略（如交给后端使用应用默认分支）。
- */
-function getCurrentGitBranch(cwd = process.cwd()) {
-    let result;
-    try {
-        result = (0, node_child_process_1.spawnSync)("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
-            cwd,
-            encoding: "utf8",
-            stdio: ["ignore", "pipe", "ignore"],
-        });
-    }
-    catch {
-        return undefined;
-    }
-    if (result.status !== 0)
-        return undefined;
-    const branch = result.stdout.trim();
-    if (!branch || branch === "HEAD")
-        return undefined;
-    return branch;
-}

package/dist/utils/time.js

@@ -1,132 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseTimeToMs = parseTimeToMs;
-exports.msToNs = msToNs;
-exports.msToSec = msToSec;
-exports.parseToMs = parseToMs;
-exports.parseToNs = parseToNs;
-exports.parseToSec = parseToSec;
-exports.floorMsToBucket = floorMsToBucket;
-exports.ceilMsToBucket = ceilMsToBucket;
-const error_1 = require("./error");
-const TIMESTAMP_HELP = "支持格式：相对时间 1h/2d/1w；日期 2026-04-01；ISO 2026-04-01T10:00:00Z";
-/**
- * 解析 PRD 时间格式。返回毫秒时间戳。
- *   - 相对时间：`1h`、`2d`、`1w`、`30m`（h=小时, d=天, w=周, m=分钟）
- *   - 日期：`2026-04-01`（按当日 00:00:00 UTC）
- *   - ISO 8601：`2026-04-01T10:00:00Z`
- *
- * 失败抛 AppError("ARGS_INVALID", ...)；CLI 层用 withHelp 自动转 exit 2 + help。
- */
-function parseTimeToMs(input, now = new Date()) {
-    const relative = /^(\d+)([mhdw])$/.exec(input);
-    if (relative) {
-        const n = Number(relative[1]);
-        const unit = relative[2];
-        const factor = unit === "m"
-            ? 60_000
-            : unit === "h"
-                ? 3_600_000
-                : unit === "d"
-                    ? 86_400_000
-                    : /* w */ 604_800_000;
-        return now.getTime() - n * factor;
-    }
-    if (/^\d{4}-\d{2}-\d{2}$/.test(input)) {
-        const ms = Date.parse(input + "T00:00:00Z");
-        if (Number.isNaN(ms))
-            failInvalidTimestamp(input);
-        return ms;
-    }
-    const ms = Date.parse(input);
-    if (Number.isNaN(ms))
-        failInvalidTimestamp(input);
-    return ms;
-}
-function failInvalidTimestamp(input) {
-    throw new error_1.AppError("ARGS_INVALID", `无法解析时间 '${input}'。${TIMESTAMP_HELP}`);
-}
-/** 毫秒 → 纳秒（字符串，避免 JS Number 精度丢失） */
-function msToNs(ms) {
-    return `${String(ms)}000000`;
-}
-/** 毫秒 → 秒（字符串，向下取整） */
-function msToSec(ms) {
-    return String(Math.floor(ms / 1000));
-}
-/** 解析到毫秒数；input 为空返回 undefined */
-function parseToMs(input, now) {
-    if (!input)
-        return undefined;
-    return parseTimeToMs(input, now);
-}
-/** 解析到纳秒字符串；input 为空返回 undefined */
-function parseToNs(input, now) {
-    if (!input)
-        return undefined;
-    return msToNs(parseTimeToMs(input, now));
-}
-/** 解析到秒字符串；input 为空返回 undefined */
-function parseToSec(input, now) {
-    if (!input)
-        return undefined;
-    return msToSec(parseTimeToMs(input, now));
-}
-// ── 桶边界对齐 ──
-//
-// metric 的 down-sample 与 analytics 的 timeAggregationUnit 都按 UTC 桶切片。
-// 当用户传的 since/until 落在桶中间，服务端可能返回不到该桶（边界数据丢失）。
-// 约定：since 向下取整、until 向上取整，把 since/until 各自所在桶完整纳入。
-//
-// 周界以 ISO 周（周一为周首，UTC）；月按 UTC 月初对齐。
-const MS_MIN = 60_000;
-const MS_HOUR = 3_600_000;
-const MS_DAY = 86_400_000;
-/** 把 ms 向下对齐到桶起点（UTC）。未识别的 bucket 原样返回。 */
-function floorMsToBucket(ms, bucket) {
-    switch (bucket) {
-        case "1m":
-            return Math.floor(ms / MS_MIN) * MS_MIN;
-        case "1h":
-            return Math.floor(ms / MS_HOUR) * MS_HOUR;
-        case "1d":
-        case "DAY": {
-            const d = new Date(ms);
-            return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate());
-        }
-        case "WEEK": {
-            const d = new Date(ms);
-            const offsetDays = (d.getUTCDay() + 6) % 7; // 距上一个周一的天数
-            return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), d.getUTCDate() - offsetDays);
-        }
-        case "MONTH": {
-            const d = new Date(ms);
-            return Date.UTC(d.getUTCFullYear(), d.getUTCMonth(), 1);
-        }
-        default:
-            return ms;
-    }
-}
-/** 把 ms 向上对齐到下一个桶起点（UTC）；恰在边界则不变。 */
-function ceilMsToBucket(ms, bucket) {
-    const floor = floorMsToBucket(ms, bucket);
-    if (floor === ms)
-        return ms;
-    switch (bucket) {
-        case "1m":
-            return floor + MS_MIN;
-        case "1h":
-            return floor + MS_HOUR;
-        case "1d":
-        case "DAY":
-            return floor + MS_DAY;
-        case "WEEK":
-            return floor + 7 * MS_DAY;
-        case "MONTH": {
-            const d = new Date(floor);
-            return Date.UTC(d.getUTCFullYear(), d.getUTCMonth() + 1, 1);
-        }
-        default:
-            return ms;
-    }
-}