@lark-apaas/miaoda-cli 0.1.1 → 0.1.2-alpha.b2b5ae5

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 shared_1 = require("../../../cli/commands/shared");
+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, shared_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 shared_1 = require("../../../cli/commands/shared");
+const index_1 = require("../../../api/observability/index");
+const helpers_1 = require("./helpers");
+/** miaoda observability log */
+async function handleObservabilityLog(opts) {
+    const appID = (0, shared_1.resolveAppId)({ appId: opts.appId });
+    const appEnv = "runtime";
+    const limit = (0, helpers_1.validateLimit)(opts.limit ?? 50);
+    // 过滤 key 对齐 BAM LogItem 字段名：
+    //   - 顶层字段：severityText / traceID（注意大小写）
+    //   - attributes 里的业务字段：module / user_id / page / api（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: "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);
+}

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

@@ -0,0 +1,208 @@
+"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

@@ -0,0 +1,102 @@
+"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/cli/handlers/plugin/plugin-local.js

@@ -82,7 +82,9 @@ function parsePluginName(input) {
 function readPackageJson() {
     const pkgPath = getPackageJsonPath();
     if (!node_fs_1.default.existsSync(pkgPath)) {
-        throw new error_1.AppError("PKG_JSON_NOT_FOUND", "package.json not found in current directory", { next_actions: ["在应用项目根目录运行"] });
+        throw new error_1.AppError("PKG_JSON_NOT_FOUND", "package.json not found in current directory", {
+            next_actions: ["在应用项目根目录运行"],
+        });
     }
     const content = node_fs_1.default.readFileSync(pkgPath, "utf-8");
     return JSON.parse(content);
@@ -189,9 +191,14 @@ function installMissingDeps(deps) {
     if (deps.length === 0)
         return;
     (0, logger_1.log)("plugin", `Installing missing dependencies: ${deps.join(", ")}`);
-    const result = (0, node_child_process_1.spawnSync)("npm", ["install", ...deps, "--no-save", "--no-package-lock"], { cwd: getProjectRoot(), stdio: "inherit" });
+    const result = (0, node_child_process_1.spawnSync)("npm", ["install", ...deps, "--no-save", "--no-package-lock"], {
+        cwd: getProjectRoot(),
+        stdio: "inherit",
+    });
     if (result.error) {
-        throw new error_1.AppError("INTERNAL_NPM_FAILED", `npm install failed: ${result.error.message}`, { next_actions: ["确认本机已安装 npm，可 --verbose 查看执行详情"] });
+        throw new error_1.AppError("INTERNAL_NPM_FAILED", `npm install failed: ${result.error.message}`, {
+            next_actions: ["确认本机已安装 npm，可 --verbose 查看执行详情"],
+        });
     }
     if (result.status !== 0) {
         throw new error_1.AppError("INTERNAL_NPM_FAILED", `npm install failed with exit code ${String(result.status)}`, { next_actions: ["检查上方 npm 输出日志定位具体错误"] });
@@ -200,7 +207,9 @@ function installMissingDeps(deps) {
 function npmInstall(tgzPath) {
     const result = (0, node_child_process_1.spawnSync)("npm", ["install", tgzPath, "--no-save", "--no-package-lock", "--ignore-scripts"], { cwd: getProjectRoot(), stdio: "inherit" });
     if (result.error) {
-        throw new error_1.AppError("INTERNAL_NPM_FAILED", `npm install failed: ${result.error.message}`, { next_actions: ["确认本机已安装 npm，可 --verbose 查看执行详情"] });
+        throw new error_1.AppError("INTERNAL_NPM_FAILED", `npm install failed: ${result.error.message}`, {
+            next_actions: ["确认本机已安装 npm，可 --verbose 查看执行详情"],
+        });
     }
     if (result.status !== 0) {
         throw new error_1.AppError("INTERNAL_NPM_FAILED", `npm install failed with exit code ${String(result.status)}`, { next_actions: ["检查上方 npm 输出日志定位具体错误"] });
@@ -232,7 +241,9 @@ function listCapabilityIds() {
 function readCapability(id) {
     const filePath = node_path_1.default.join(getCapabilitiesDir(), `${id}.json`);
     if (!node_fs_1.default.existsSync(filePath)) {
-        throw new error_1.AppError("CAPABILITY_NOT_FOUND", `Capability not found: ${id}`, { next_actions: ["运行 miaoda plugin list 查看所有可用 capability id"] });
+        throw new error_1.AppError("CAPABILITY_NOT_FOUND", `Capability not found: ${id}`, {
+            next_actions: ["运行 miaoda plugin list 查看所有可用 capability id"],
+        });
     }
     try {
         const content = node_fs_1.default.readFileSync(filePath, "utf-8");
@@ -240,7 +251,9 @@ function readCapability(id) {
     }
     catch (error) {
         if (error instanceof SyntaxError) {
-            throw new error_1.AppError("INVALID_JSON", `Invalid JSON in capability file: ${id}.json`, { next_actions: [`检查 server/capabilities/${id}.json 的 JSON 语法`] });
+            throw new error_1.AppError("INVALID_JSON", `Invalid JSON in capability file: ${id}.json`, {
+                next_actions: [`检查 server/capabilities/${id}.json 的 JSON 语法`],
+            });
         }
         throw error;
     }
@@ -303,7 +316,9 @@ async function loadPlugin(pluginKey) {
     }
     catch (error) {
         if (error.code === "MODULE_NOT_FOUND") {
-            throw new error_1.AppError("PLUGIN_NOT_FOUND", `Plugin not installed: ${pluginKey}`, { next_actions: [`运行 miaoda plugin install ${pluginKey}`] });
+            throw new error_1.AppError("PLUGIN_NOT_FOUND", `Plugin not installed: ${pluginKey}`, {
+                next_actions: [`运行 miaoda plugin install ${pluginKey}`],
+            });
         }
         throw new error_1.AppError("INTERNAL_PLUGIN_LOAD_FAILED", `Failed to load plugin ${pluginKey}: ${error instanceof Error ? error.message : String(error)}`);
     }
@@ -314,8 +329,7 @@ async function hydrateCapability(capability) {
         if (manifest.actions.length === 0) {
             throw new error_1.AppError("INTERNAL_PLUGIN_LOAD_FAILED", `Plugin ${capability.pluginKey} has no actions defined`);
         }
-        const hasDynamic = manifest.actions.some((action) => isDynamicSchema(action.inputSchema) ||
-            isDynamicSchema(action.outputSchema));
+        const hasDynamic = manifest.actions.some((action) => isDynamicSchema(action.inputSchema) || isDynamicSchema(action.outputSchema));
         let pluginInstance = null;
         if (hasDynamic) {
             const plugin = await loadPlugin(capability.pluginKey);

package/dist/cli/handlers/plugin/plugin.js

@@ -44,7 +44,9 @@ const output_1 = require("../../../utils/output");
 const error_1 = require("../../../utils/error");
 const logger_1 = require("../../../utils/logger");
 const plugin_local_1 = require("./plugin-local");
-const log = (msg) => { (0, logger_1.log)("plugin", msg); };
+const log = (msg) => {
+    (0, logger_1.log)("plugin", msg);
+};
 // ── Install ──
 function syncActionPluginsRecord(name, version) {
     const plugins = (0, plugin_local_1.readActionPlugins)();
@@ -63,7 +65,9 @@ async function installOne(nameWithVersion) {
             if (actualVersion === requestedVersion) {
                 log(`${name}@${requestedVersion} already installed`);
                 syncActionPluginsRecord(name, actualVersion);
-                api.plugin.reportCreateInstanceEvent(name, actualVersion).catch(() => { });
+                api.plugin.reportCreateInstanceEvent(name, actualVersion).catch(() => {
+                    /* fire-and-forget */
+                });
                 return { name, version: actualVersion, success: true, skipped: true };
             }
         }
@@ -74,7 +78,9 @@ async function installOne(nameWithVersion) {
             if (actualVersion === targetVersion) {
                 log(`${name} already up to date (${actualVersion})`);
                 syncActionPluginsRecord(name, actualVersion);
-                api.plugin.reportCreateInstanceEvent(name, actualVersion).catch(() => { });
+                api.plugin.reportCreateInstanceEvent(name, actualVersion).catch(() => {
+                    /* fire-and-forget */
+                });
                 return { name, version: actualVersion, success: true, skipped: true };
             }
             log(`Found newer version: ${targetVersion} (installed: ${actualVersion ?? "none"})`);
@@ -106,8 +112,12 @@ async function installOne(nameWithVersion) {
         (0, plugin_local_1.writeActionPlugins)(plugins);
         const source = fromCache ? "from cache" : "downloaded";
         log(`Installed ${name}@${installedVersion} (${source})`);
-        api.plugin.reportInstallEvent(name, installedVersion).catch(() => { });
-        api.plugin.reportCreateInstanceEvent(name, installedVersion).catch(() => { });
+        api.plugin.reportInstallEvent(name, installedVersion).catch(() => {
+            /* fire-and-forget */
+        });
+        api.plugin.reportCreateInstanceEvent(name, installedVersion).catch(() => {
+            /* fire-and-forget */
+        });
         return { name, version: installedVersion, success: true };
     }
     catch (error) {
@@ -193,7 +203,9 @@ async function handlePluginUpdate(opts) {
 function handlePluginRemove(opts) {
     const { name } = (0, plugin_local_1.parsePluginName)(opts.name);
     if (!(0, plugin_local_1.isPluginInstalled)(name)) {
-        throw new error_1.AppError("PLUGIN_NOT_FOUND", `Plugin ${name} is not installed`, { next_actions: ["运行 miaoda plugin list-packages 查看已安装插件"] });
+        throw new error_1.AppError("PLUGIN_NOT_FOUND", `Plugin ${name} is not installed`, {
+            next_actions: ["运行 miaoda plugin list-packages 查看已安装插件"],
+        });
     }
     (0, plugin_local_1.removePluginDirectory)(name);
     const plugins = (0, plugin_local_1.readActionPlugins)();
@@ -263,7 +275,9 @@ async function handlePluginInit() {
 // ── List (capability configs) ──
 async function handlePluginList(opts) {
     if (!(0, plugin_local_1.capabilitiesDirExists)()) {
-        throw new error_1.AppError("CAPABILITIES_DIR_NOT_FOUND", "server/capabilities directory not found", { next_actions: ["当前目录必须是含 server/capabilities/ 的应用项目"] });
+        throw new error_1.AppError("CAPABILITIES_DIR_NOT_FOUND", "server/capabilities directory not found", {
+            next_actions: ["当前目录必须是含 server/capabilities/ 的应用项目"],
+        });
     }
     if (opts.id) {
         const capability = (0, plugin_local_1.readCapability)(opts.id);

package/dist/cli/help.js

@@ -115,7 +115,9 @@ class MiaodaHelp extends commander_1.Help {
         out.push("Usage:", `  ${helper.commandUsage(cmd)}`, "");
         // 3. Commands（仅父级命令组有，spec 要求 Commands 在 Flags 前）
         //    spec 不展示 Arguments 段，参数说明放在 description 文本里
-        const subs = helper.visibleCommands(cmd).map((c) => formatItem(helper.subcommandTerm(c), helper.subcommandDescription(c)));
+        const subs = helper
+            .visibleCommands(cmd)
+            .map((c) => formatItem(helper.subcommandTerm(c), helper.subcommandDescription(c)));
         if (subs.length) {
             out.push("Commands:", formatList(subs), "");
         }
@@ -125,7 +127,8 @@ class MiaodaHelp extends commander_1.Help {
         //    - `-h, --help` 永远不放 Flags 段，统一放 Global Flags（spec 约定）
         const isParent = subs.length > 0;
         if (!isRoot && !isParent) {
-            const opts = helper.visibleOptions(cmd)
+            const opts = helper
+                .visibleOptions(cmd)
                 .filter((o) => !isHelpOption(o))
                 .map((o) => formatItem(helper.optionTerm(o), helper.optionDescription(o)));
             if (opts.length) {