@lark-apaas/miaoda-cli 0.1.4 → 0.1.5-beta.27ede41

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

@@ -1,7 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleAppUpdate = exports.handleAppGet = void 0;
+exports.SUPPORTED_STACKS = exports.handleAppInit = exports.handleAppUpdate = exports.handleAppGet = void 0;
 var get_1 = require("./get");
 Object.defineProperty(exports, "handleAppGet", { enumerable: true, get: function () { return get_1.handleAppGet; } });
 var update_1 = require("./update");
 Object.defineProperty(exports, "handleAppUpdate", { enumerable: true, get: function () { return update_1.handleAppUpdate; } });
+var init_1 = require("./init");
+Object.defineProperty(exports, "handleAppInit", { enumerable: true, get: function () { return init_1.handleAppInit; } });
+// commands 层渲染 help 时需要这份枚举；从 handler barrel 转发，避免 commands → services 越界
+var index_1 = require("../../../services/app/init/index");
+Object.defineProperty(exports, "SUPPORTED_STACKS", { enumerable: true, get: function () { return index_1.SUPPORTED_STACKS; } });

package/dist/cli/handlers/app/init.js

@@ -0,0 +1,88 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleAppInit = handleAppInit;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const index_1 = require("../../../services/app/init/index");
+const coding_steering_1 = require("../../../utils/coding-steering");
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+/**
+ * miaoda app init
+ *
+ * 只负责本地脚手架：render template、sync skills、install deps，把 {stack, version, archType}
+ * 写入 .spark/meta.json。appId 不在此处持久化——deploy 等运行端通过 MIAODA_APP_ID env 拿。
+ *
+ * 幂等：.spark/meta.json 存在即表示已完整成功一次，直接退出，不重跑任何子步骤。
+ * 半渲染状态（package.json 在但 meta.json 不在）会重新跑完整流程。
+ */
+async function handleAppInit(opts) {
+    await Promise.resolve();
+    const targetDir = opts.targetDir ?? process.cwd();
+    const metaPath = node_path_1.default.join(targetDir, '.spark', 'meta.json');
+    if (node_fs_1.default.existsSync(metaPath)) {
+        if (!(0, output_1.isJsonMode)()) {
+            process.stdout.write(`Already initialized: ${metaPath}\n`);
+        }
+        (0, output_1.emit)({
+            data: {
+                initialized: false,
+                reason: 'already_initialized',
+                targetDir,
+            },
+        });
+        return;
+    }
+    const stack = opts.template;
+    if (!stack) {
+        throw new error_1.AppError('ARGS_INVALID', '缺少 --template <stack>', {
+            next_actions: [`可用 stack：${index_1.SUPPORTED_STACKS.join(', ')}`],
+        });
+    }
+    if (!index_1.SUPPORTED_STACKS.includes(stack)) {
+        throw new error_1.AppError('ARGS_INVALID', `不支持的 template: ${stack}`, {
+            next_actions: [`可用 stack：${index_1.SUPPORTED_STACKS.join(', ')}`],
+        });
+    }
+    const version = opts.conf?.version;
+    const projectName = node_path_1.default.basename(targetDir);
+    const tplResult = (0, index_1.renderTemplate)({ stack, version, targetDir, projectName });
+    const steeringResult = (0, coding_steering_1.syncCodingSteering)({
+        stack,
+        targetDir,
+        version: opts.conf?.steeringVersion,
+        logPrefix: 'init',
+    });
+    const installResult = (0, index_1.installDependencies)({
+        targetDir,
+        skip: opts.skipInstall,
+        quietStdout: (0, output_1.isJsonMode)(),
+    });
+    (0, index_1.writeSparkMeta)(targetDir, {
+        stack,
+        version: tplResult.version,
+        archType: tplResult.archType,
+    });
+    if (!(0, output_1.isJsonMode)()) {
+        process.stdout.write(`✓ Initialized ${stack} (template ${tplResult.version}, steering ${steeringResult.version}, install ${installResult.source}) in ${targetDir}\n`);
+    }
+    (0, output_1.emit)({
+        data: {
+            initialized: true,
+            template: stack,
+            templatePackage: tplResult.packageName,
+            templateVersion: tplResult.version,
+            steeringVersion: steeringResult.version,
+            archType: tplResult.archType,
+            syncedSkills: steeringResult.syncedSkills,
+            techSynced: steeringResult.techSynced,
+            installed: installResult.installed,
+            installSource: installResult.source,
+            installHash: installResult.hash,
+            cacheZip: installResult.cacheZip,
+        },
+    });
+}

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

@@ -0,0 +1,33 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleDeployModern = handleDeployModern;
+const node_path_1 = __importDefault(require("node:path"));
+const output_1 = require("../../../utils/output");
+const index_1 = require("../../../services/deploy/modern/index");
+/**
+ * miaoda deploy（modern scene 专用，CLI 表面对齐 openclaw-cli）
+ *
+ * 进程信息走 stderr（log_id / step），最终结果通过 emit 输出 envelope 到 stdout。
+ */
+async function handleDeployModern(opts) {
+    const projectDir = node_path_1.default.resolve(opts.dir);
+    const result = await (0, index_1.runModernDeploy)({
+        projectDir,
+        appId: opts.appId,
+        skipBuild: opts.skipBuild ?? false,
+    });
+    (0, output_1.emit)({
+        data: {
+            appId: result.appId,
+            version: result.version,
+            url: result.url,
+            releaseID: result.releaseID,
+            preReleaseID: result.preReleaseID,
+        },
+        next_cursor: null,
+        has_more: false,
+    });
+}

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

@@ -2,6 +2,7 @@
 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.inFilter = inFilter;
 exports.rangeFilter = rangeFilter;
 exports.fuzzyFilter = fuzzyFilter;
 exports.buildFieldFilters = buildFieldFilters;
@@ -27,6 +28,9 @@ function eqFilter(value, type = 'str') {
     const v = type !== 'str' ? Number(value) : value;
     return { [type]: { eq: v } };
 }
+function inFilter(strs) {
+    return { str: { in: strs } };
+}
 /** i64 数值范围过滤 → { i64: { gte, lte } }；输入接受 string（CLI flag）或 number */
 function rangeFilter(opts) {
     const i64 = {};

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

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleObservabilityAnalytics = exports.handleObservabilityMetric = exports.handleObservabilityTraceGet = exports.handleObservabilityTraceList = exports.handleObservabilityLog = void 0;
+exports.handleObservabilityAnalytics = exports.handleObservabilityMetric = exports.handleObservabilitySourceStack = 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 source_stack_1 = require("./source-stack");
+Object.defineProperty(exports, "handleObservabilitySourceStack", { enumerable: true, get: function () { return source_stack_1.handleObservabilitySourceStack; } });
 var metric_1 = require("./metric");
 Object.defineProperty(exports, "handleObservabilityMetric", { enumerable: true, get: function () { return metric_1.handleObservabilityMetric; } });
 var analytics_1 = require("./analytics");

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

@@ -38,6 +38,12 @@ const api = __importStar(require("../../../api/index"));
 const output_1 = require("../../../utils/output");
 const index_1 = require("../../../api/observability/index");
 const helpers_1 = require("./helpers");
+function stringIdFilter(value) {
+    if (Array.isArray(value)) {
+        return value.length > 0 ? (0, helpers_1.inFilter)(value) : undefined;
+    }
+    return value ? (0, helpers_1.eqFilter)(value) : undefined;
+}
 /** miaoda observability log */
 async function handleObservabilityLog(opts) {
     const appID = opts.appId;
@@ -50,8 +56,8 @@ async function handleObservabilityLog(opts) {
     //   - 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: 'attributes.ob_data_id', value: stringIdFilter(opts.logId) },
+        { key: 'trace_id', value: stringIdFilter(opts.traceId) },
         { 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 },

package/dist/cli/handlers/observability/source-stack.js

@@ -0,0 +1,389 @@
+"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.handleObservabilitySourceStack = handleObservabilitySourceStack;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const args_1 = require("../../../utils/args");
+const helpers_1 = require("./helpers");
+const SOURCE_MAP_FILE_PREFIX = 'client/assets/';
+/** miaoda observability source-stack */
+async function handleObservabilitySourceStack(opts) {
+    const logIds = normalizeValues(opts.logId);
+    const traceIds = normalizeValues(opts.traceId);
+    if (logIds.length === 0 && traceIds.length === 0) {
+        (0, args_1.failArgs)('至少传入线上环境日志 ID 或 trace ID');
+    }
+    const logs = await collectCandidateLogs(opts, { logIds, traceIds });
+    const results = await resolveCandidateLogs(opts.appId, logs);
+    (0, output_1.emit)({ data: results, next_cursor: null, has_more: false });
+}
+async function collectCandidateLogs(opts, params) {
+    const limit = (0, helpers_1.validateLimit)(opts.limit ?? 50);
+    const searches = [];
+    if (params.logIds.length > 0) {
+        searches.push(searchLogs(opts, {
+            limit,
+            fieldFilters: (0, helpers_1.buildFieldFilters)([
+                { key: 'attributes.ob_data_id', value: stringIdFilter(params.logIds) },
+            ]),
+        }));
+    }
+    if (params.traceIds.length > 0) {
+        searches.push(searchLogs(opts, {
+            limit,
+            fieldFilters: (0, helpers_1.buildFieldFilters)([
+                { key: 'trace_id', value: stringIdFilter(params.traceIds) },
+            ]),
+        }));
+    }
+    const allLogs = (await Promise.all(searches)).flat();
+    const deduped = new Map();
+    for (const log of allLogs) {
+        deduped.set(log.id, log);
+    }
+    return Array.from(deduped.values());
+}
+async function searchLogs(opts, params) {
+    const req = {
+        appID: opts.appId,
+        appEnv: 'runtime',
+        startTimestampNs: (0, helpers_1.parseToNs)(opts.since),
+        endTimestampNs: (0, helpers_1.parseToNs)(opts.until),
+        limit: params.limit,
+        fieldFilters: params.fieldFilters,
+    };
+    const resp = await api.observability.searchLogs(req);
+    return resp.logItems ?? [];
+}
+async function resolveCandidateLogs(appID, logs) {
+    const results = [];
+    for (const log of logs) {
+        const attrs = log.attributes ?? {};
+        const rawStack = pickAttr(attrs, ['stack', 'error_stack', 'errorStack']) ??
+            pickBodyStack(log.body) ??
+            log.body;
+        const frames = parseGeneratedFrames(rawStack);
+        const commitID = pickAttr(attrs, [
+            'release_commit_id',
+            'releaseCommitID',
+            'commit_id',
+            'commitID',
+        ]);
+        const message = pickErrorMessage(log, rawStack);
+        const base = {
+            log_id: log.id,
+            trace_id: log.traceID ?? attrs.trace_id,
+            commit_id: commitID,
+            source_map_files: sourceMapFilesForFrames(frames),
+        };
+        const reason = missingReason({ frames, commitID });
+        if (reason) {
+            results.push({
+                ...base,
+                status: 'unresolved',
+                reason,
+                error_message_stack: formatStack(message, frames),
+            });
+            continue;
+        }
+        const resolvedCommitID = commitID;
+        if (!resolvedCommitID)
+            continue;
+        let resolvedFrames;
+        try {
+            resolvedFrames = await resolveFramesBySourceMap(appID, resolvedCommitID, frames);
+        }
+        catch (err) {
+            results.push({
+                ...base,
+                status: 'unresolved',
+                reason: `调用 resolve_stack_trace 失败：${errorMessage(err)}`,
+                error_message_stack: formatStack(message, frames),
+            });
+            continue;
+        }
+        results.push({
+            ...base,
+            status: 'resolved',
+            error_message_stack: formatStack(message, resolvedFrames),
+        });
+    }
+    return results;
+}
+function normalizeValues(value) {
+    if (Array.isArray(value)) {
+        return value.filter((item) => item.length > 0);
+    }
+    return value ? [value] : [];
+}
+function stringIdFilter(values) {
+    if (values.length === 0)
+        return undefined;
+    return values.length === 1 ? (0, helpers_1.eqFilter)(values[0]) : (0, helpers_1.inFilter)(values);
+}
+function pickAttr(attrs, keys) {
+    for (const key of keys) {
+        const value = attrs[key];
+        if (value)
+            return value;
+    }
+    return undefined;
+}
+async function resolveFramesBySourceMap(appID, commitID, frames) {
+    const resp = await api.observability.resolveStackTrace({
+        appID,
+        commitID,
+        sourceMapFilePrefix: SOURCE_MAP_FILE_PREFIX,
+        frames,
+    });
+    return resp.frames ?? frames;
+}
+function parseGeneratedFrames(stack) {
+    if (!stack)
+        return [];
+    const jsonFrames = parseJsonStackFrames(stack);
+    if (jsonFrames.length > 0)
+        return jsonFrames;
+    const frames = [];
+    const parenFramePattern = /\((.+):(\d+):(\d+)\)$/;
+    const plainFramePattern = /(?:at\s+)?(.+):(\d+):(\d+)$/;
+    for (const line of stack.split('\n')) {
+        const trimmed = line.trim();
+        const match = parenFramePattern.exec(trimmed) ?? plainFramePattern.exec(trimmed);
+        if (!match)
+            continue;
+        const [, fileName, lineNumber, columnNumber] = match;
+        if (!fileName || !lineNumber || !columnNumber)
+            continue;
+        frames.push({
+            fileName: normalizeFrameFileName(fileName),
+            line: Number(lineNumber),
+            column: Number(columnNumber),
+        });
+    }
+    return frames.slice(0, 2000);
+}
+function parseJsonStackFrames(stack) {
+    const trimmed = stack.trim();
+    if (!trimmed.startsWith('['))
+        return [];
+    let parsed;
+    try {
+        parsed = JSON.parse(trimmed);
+    }
+    catch {
+        return [];
+    }
+    if (!Array.isArray(parsed))
+        return [];
+    return parsed
+        .map((item) => normalizeJsonFrame(item))
+        .filter((frame) => Boolean(frame))
+        .slice(0, 2000);
+}
+function normalizeJsonFrame(item) {
+    if (!isRecord(item))
+        return undefined;
+    const fileName = item.fileName;
+    const line = item.line;
+    const column = item.column;
+    if (typeof fileName !== 'string')
+        return undefined;
+    const lineNumber = toFiniteNumber(line);
+    const columnNumber = toFiniteNumber(column);
+    if (lineNumber === undefined || columnNumber === undefined)
+        return undefined;
+    return {
+        fileName: normalizeFrameFileName(fileName),
+        line: lineNumber,
+        column: columnNumber,
+    };
+}
+function pickErrorMessage(log, rawStack) {
+    return (pickBodyErrorMessage(log.body) ??
+        firstTextStackLine(rawStack) ??
+        pickAttr(log.attributes ?? {}, ['error_message', 'errorMessage', 'message']));
+}
+function pickBodyStack(body) {
+    const parsed = parseBodyRecord(body);
+    if (!parsed)
+        return undefined;
+    return (stringProp(parsed, 'stack') ??
+        nestedStringProp(parsed, ['error', 'stack']) ??
+        nestedStringProp(parsed, ['response', 'error', 'stack']) ??
+        pickConsoleArgsStack(parsed));
+}
+function pickBodyErrorMessage(body) {
+    const parsed = parseBodyRecord(body);
+    if (!parsed)
+        return undefined;
+    return (stringProp(parsed, 'error_message') ??
+        stringProp(parsed, 'message') ??
+        nestedStringProp(parsed, ['error', 'message']) ??
+        nestedStringProp(parsed, ['response', 'error', 'message']) ??
+        pickConsoleArgsMessage(parsed));
+}
+function pickConsoleArgsMessage(record) {
+    const parts = Object.entries(record)
+        .filter(([key]) => /^\d+$/.test(key))
+        .sort(([left], [right]) => Number(left) - Number(right))
+        .map(([, value]) => consoleArgMessage(value))
+        .filter((message) => Boolean(message));
+    if (parts.length === 0)
+        return undefined;
+    return parts.join(' ').replace(/\s+/g, ' ').trim();
+}
+function pickConsoleArgsStack(record) {
+    return Object.entries(record)
+        .filter(([key]) => /^\d+$/.test(key))
+        .sort(([left], [right]) => Number(left) - Number(right))
+        .map(([, value]) => consoleArgStack(value))
+        .find((stack) => Boolean(stack));
+}
+function consoleArgStack(value) {
+    if (typeof value === 'string') {
+        const stack = value.trim();
+        return looksLikeTextStack(stack) ? stack : undefined;
+    }
+    if (!isRecord(value))
+        return undefined;
+    return (stringProp(value, 'stack') ??
+        nestedStringProp(value, ['error', 'stack']) ??
+        nestedStringProp(value, ['response', 'error', 'stack']));
+}
+function consoleArgMessage(value) {
+    if (typeof value === 'string') {
+        const message = value.trim();
+        return message.length > 0 ? message : undefined;
+    }
+    if (!isRecord(value))
+        return undefined;
+    return errorRecordMessage(value);
+}
+function errorRecordMessage(record) {
+    const stackTitle = firstTextStackLine(stringProp(record, 'stack'));
+    if (stackTitle)
+        return stackTitle;
+    const name = stringProp(record, 'name');
+    const message = stringProp(record, 'message') ??
+        nestedStringProp(record, ['error', 'message']) ??
+        nestedStringProp(record, ['response', 'error', 'message']);
+    if (name && message && !message.startsWith(`${name}:`)) {
+        return `${name}: ${message}`;
+    }
+    return message ?? name;
+}
+function parseBodyRecord(body) {
+    if (!body)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch {
+        return undefined;
+    }
+    return isRecord(parsed) ? parsed : undefined;
+}
+function firstTextStackLine(stack) {
+    const trimmed = stack?.trim();
+    if (!trimmed || trimmed.startsWith('['))
+        return undefined;
+    return trimmed
+        .split('\n')
+        .map((line) => line.trim())
+        .find((line) => line.length > 0 && !line.startsWith('at '));
+}
+function looksLikeTextStack(value) {
+    return value.length > 0 && /:\d+:\d+(?:\)|$)/.test(value);
+}
+function missingReason(params) {
+    if (!params.commitID)
+        return '日志缺少 release_commit_id / commit_id，无法定位构建产物';
+    if (params.frames.length === 0)
+        return '日志中没有可解析的 generated stack frame';
+    return undefined;
+}
+function normalizeFrameFileName(fileName) {
+    return fileName.split(/[/?#]/).filter(Boolean).pop() ?? fileName;
+}
+function formatStack(message, frames) {
+    const stack = frames
+        .map((frame) => {
+        if (frame.sourceFileName) {
+            return `  at ${frame.sourceFileName}:${String(frame.sourceLine)}:${String(frame.sourceColumn)}`;
+        }
+        return `  at ${frame.fileName}:${String(frame.line)}:${String(frame.column)}`;
+    })
+        .join('\n');
+    if (message && stack)
+        return `${message}\n${stack}`;
+    return message ?? stack;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+function toFiniteNumber(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string' && value.trim()) {
+        const numberValue = Number(value);
+        return Number.isFinite(numberValue) ? numberValue : undefined;
+    }
+    return undefined;
+}
+function stringProp(record, key) {
+    const value = record[key];
+    return typeof value === 'string' && value.length > 0 ? value : undefined;
+}
+function nestedStringProp(record, path) {
+    let current = record;
+    for (const key of path) {
+        if (!isRecord(current))
+            return undefined;
+        current = current[key];
+    }
+    return typeof current === 'string' && current.length > 0 ? current : undefined;
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function sourceMapFileForFrame(fileName) {
+    return `${SOURCE_MAP_FILE_PREFIX}${fileName}.map`;
+}
+function sourceMapFilesForFrames(frames) {
+    return Array.from(new Set(frames.map((frame) => sourceMapFileForFrame(frame.fileName))));
+}

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

@@ -40,6 +40,12 @@ const output_1 = require("../../../utils/output");
 const args_1 = require("../../../utils/args");
 const index_1 = require("../../../api/observability/index");
 const helpers_1 = require("./helpers");
+function stringIdFilter(value) {
+    if (Array.isArray(value)) {
+        return value.length > 0 ? (0, helpers_1.inFilter)(value) : undefined;
+    }
+    return value ? (0, helpers_1.eqFilter)(value) : undefined;
+}
 /** miaoda observability trace list */
 async function handleObservabilityTraceList(opts) {
     const appID = opts.appId;
@@ -51,7 +57,7 @@ async function handleObservabilityTraceList(opts) {
     //   - 入口 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: 'trace_id', value: stringIdFilter(opts.traceId) },
         { key: 'user_id', value: opts.userId ? (0, helpers_1.eqFilter)(opts.userId, 'i64') : undefined },
     ]);
     const req = {

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSkillsStatus = exports.handleSkillsSync = void 0;
+var sync_1 = require("./sync");
+Object.defineProperty(exports, "handleSkillsSync", { enumerable: true, get: function () { return sync_1.handleSkillsSync; } });
+var status_1 = require("./status");
+Object.defineProperty(exports, "handleSkillsStatus", { enumerable: true, get: function () { return status_1.handleSkillsStatus; } });

package/dist/cli/handlers/skills/status.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleSkillsStatus = handleSkillsStatus;
+const node_path_1 = __importDefault(require("node:path"));
+const index_1 = require("../../../services/skills/index");
+const spark_meta_1 = require("../../../utils/spark-meta");
+const output_1 = require("../../../utils/output");
+/**
+ * miaoda skills status [--dir <path>]
+ *
+ * 从 .spark/meta.json 读 stack，扫描 <dir>/.agent/steering/<stack>/，
+ * 给出当前装了哪些 skills、tech.md 是否在。纯本地操作，不联网。
+ * meta 缺 stack 时返回 present=false（不抛错，方便和 init 的引导分开）。
+ */
+async function handleSkillsStatus(opts) {
+    await Promise.resolve();
+    const targetDir = node_path_1.default.resolve(opts.dir ?? process.cwd());
+    const meta = (0, spark_meta_1.readSparkMeta)(targetDir);
+    const status = (0, index_1.readSkillsStatus)({ targetDir, stack: meta.stack });
+    (0, output_1.emit)({
+        data: {
+            stack: meta.stack ?? null,
+            present: status.present,
+            skills: status.skills,
+            techSynced: status.techSynced,
+        },
+    });
+}