oh-my-knowledge 0.28.0 → 0.30.0

package/dist/src/observability/trace-attribution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-attribution.js","sourceRoot":"","sources":["../../../src/observability/trace-attribution.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAYjD,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,QAAQ,GAAG;QACf,oEAAoE;QACpE,0CAA0C;QAC1C,wCAAwC;QACxC,wCAAwC;QACxC,iCAAiC;QACjC,2CAA2C;KAC5C,CAAC;IACF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAClC,MAAM,UAAU,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACpE,IAAI,UAAU;YAAE,OAAO,UAAU,CAAC;IACpC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,eAAe,GAAG,yCAAyC,CAAC;AAClE,MAAM,WAAW,GAAG,+CAA+C,CAAC;AACpE,MAAM,mBAAmB,GAAG,iEAAiE,CAAC;AAE9F,8DAA8D;AAC9D,0CAA0C;AAC1C,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO;IAC1D,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAChE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ;CACxD,CAAC,CAAC;AAEH;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,aAAa,CAAC,GAAG,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,uEAAuE;IACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1C,MAAM,IAAI,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACnE,IAAI,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,UAAU,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,OAAO;QACL,SAAS,EAAE,IAAI;QACf,WAAW,EAAE,OAAO;QACpB,UAAU,EAAE,UAAU,IAAI,SAAS;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAChD,OAAO,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACrC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAoB;IACtD,OAAO,sBAAsB,CAAC,MAAM,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAoB;IACzD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IACvC,IAAI,GAAG,GAAkB,IAAI,CAAC;IAC9B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACxC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACzB,MAAM,CAAC,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC1C,IAAI,CAAC,EAAE,CAAC;oBAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;oBAAC,MAAM;gBAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAoB;IACzD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IACvC,IAAI,GAAG,GAAkB,IAAI,CAAC;IAC9B,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;gBACzB,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACtC,IAAI,CAAC,EAAE,CAAC;oBAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;oBAAC,MAAM;gBAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,GAAG,IAAI,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACnE,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,OAAO,8BAA8B,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC/E,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAyB;IAC3D,OAAO,sBAAsB,CAAC,MAAM,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,MAAyB;IAC9D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YACtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC;YAChC,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAyB;IAC/D,OAAO,0BAA0B,CAAC,MAAM,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAyB;IAClE,OAAO,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjF,CAAC;AAED,0GAA0G;AAC1G,MAAM,kBAAkB,GAAG,mFAAmF,CAAC;AAC/G,MAAM,oBAAoB,GAAG,oFAAoF,CAAC;AAElH;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAyB;IAC5D,OAAO,uBAAuB,CAAC,MAAM,CAAC,EAAE,SAAS,IAAI,IAAI,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAyB;IAC/D,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAE,SAAS,CAAC;YACvC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACjC,MAAM,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC5C,IAAI,CAAC;oBAAE,OAAO,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAwC;IACnF,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IACvC,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1D,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;gBACpC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;gBACpC,IAAI,OAAO,OAAO,KAAK,QAAQ;oBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvD,CAAC;QACH,CAAC;IACH,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC;YAAE,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/observability/trace-segmenter.d.ts

@@ -0,0 +1,52 @@
+/** Skill segmentation and ResultEntry projection for loaded traces. */
+import type { ResultEntry, ToolCallInfo, TurnInfo } from '../types/index.js';
+import type { CcSession } from './trace-source.js';
+export interface SkillSegment {
+    skillName: string;
+    attribution?: {
+        source: 'skill-tool' | 'command-name' | 'aima-cmd' | 'read-skill-md' | 'skill-script' | 'general';
+        confidence: number;
+        rawSkillRef?: string;
+        pluginName?: string;
+        commandName?: string;
+    };
+    sessionId: string;
+    traceSessionId?: string;
+    sourceTrace?: string;
+    sourceKind?: 'claude' | 'openclaw' | 'markdown_log' | 'unknown';
+    traceRole?: 'standalone' | 'main' | 'subagent';
+    traceLabel?: string;
+    segmentIndex: number;
+    startRecordIndex?: number;
+    endRecordIndex?: number;
+    startTimestamp: string;
+    endTimestamp: string;
+    cwd?: string;
+    turns: TurnInfo[];
+    toolCalls: ToolCallInfo[];
+    metrics: {
+        durationMs: number;
+        inputTokens: number;
+        outputTokens: number;
+        cacheReadTokens: number;
+        cacheCreationTokens: number;
+        numTurns: number;
+        numToolCalls: number;
+        numToolFailures: number;
+    };
+}
+/**
+ * 扫描 session records, 按 skill 信号把 tool calls 切成多段。
+ * 一个 session 可能产生 1-N 个 SkillSegment。
+ */
+export declare function segmentBySkill(session: CcSession): SkillSegment[];
+/**
+ * SkillSegment[] → ResultEntry[] (omk 内部分析路径的标准输入)。
+ *
+ * 映射规则(详见 docs/skill-health-spec.md):
+ *   - 每 segment 一个 ResultEntry
+ *   - sample_id = `${sessionId}:${segmentIndex}`
+ *   - variant key = skill 名(复用 omk 的 variant 维度作为 skill 分组维度)
+ */
+export declare function segmentsToResultEntries(segments: SkillSegment[]): ResultEntry[];
+//# sourceMappingURL=trace-segmenter.d.ts.map

package/dist/src/observability/trace-segmenter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-segmenter.d.ts","sourceRoot":"","sources":["../../../src/observability/trace-segmenter.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAiB,MAAM,mBAAmB,CAAC;AAC5F,OAAO,KAAK,EAAqB,SAAS,EAAgB,MAAM,mBAAmB,CAAC;AAYpF,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE;QACZ,MAAM,EAAE,YAAY,GAAG,cAAc,GAAG,UAAU,GAAG,eAAe,GAAG,cAAc,GAAG,SAAS,CAAC;QAClG,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,cAAc,GAAG,SAAS,CAAC;IAChE,SAAS,CAAC,EAAE,YAAY,GAAG,MAAM,GAAG,UAAU,CAAC;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,QAAQ,EAAE,MAAM,CAAC;QACjB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;KACzB,CAAC;CACH;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,GAAG,YAAY,EAAE,CA+MjE;AAgED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,CAO/E"}

package/dist/src/observability/trace-segmenter.js

@@ -0,0 +1,320 @@
+/** Skill segmentation and ResultEntry projection for loaded traces. */
+import { extractAimaCmdSkillRef, extractAttributionSkillRef, extractCommandSkillRef, extractSkillReadFileRef, extractSkillScriptCommandRef, extractSkillToolUseRef, stripCommandEnvelopeText, } from './trace-attribution.js';
+// ---------- Segment by skill ----------
+/**
+ * 扫描 session records, 按 skill 信号把 tool calls 切成多段。
+ * 一个 session 可能产生 1-N 个 SkillSegment。
+ */
+export function segmentBySkill(session) {
+    const segments = [];
+    let currentSkill = 'general';
+    let currentSkillSource;
+    let currentSegment = createEmptySegment(session, currentSkill, 0, 0);
+    let segmentIndex = 0;
+    // 用 tool_use_id → ToolCallInfo 的映射, 收到 tool_result 时回填 output / success
+    const pendingToolUses = new Map();
+    const markCurrentRecord = (recordIndex) => {
+        currentSegment.endRecordIndex = Math.max(currentSegment.endRecordIndex ?? currentSegment.startRecordIndex ?? recordIndex, recordIndex);
+    };
+    const flushCurrent = (endRecordIndex) => {
+        if (currentSegment.turns.length > 0 || currentSegment.toolCalls.length > 0) {
+            if (typeof endRecordIndex === 'number') {
+                const start = currentSegment.startRecordIndex ?? 0;
+                currentSegment.endRecordIndex = Math.max(start, Math.min(session.records.length - 1, endRecordIndex));
+            }
+            segments.push(currentSegment);
+            return true;
+        }
+        return false;
+    };
+    const isCurrentSkillRef = (ref) => ref.skillName === currentSkill && (ref.pluginName ?? '') === (currentSkillSource ?? '');
+    const startNewSegment = (ref, recordIndex, timestamp, attribution) => {
+        // 空段被新信号替换时,不推进 segmentIndex(保持整洁的 0-based 编号)
+        const wasNonEmpty = flushCurrent(recordIndex - 1);
+        if (wasNonEmpty)
+            segmentIndex += 1;
+        currentSegment = createEmptySegment(session, ref.skillName, segmentIndex, recordIndex, timestamp, attribution);
+        currentSkill = ref.skillName;
+        currentSkillSource = ref.pluginName;
+    };
+    for (const [recordIndex, raw] of session.records.entries()) {
+        // records 是 unknown[], 按 type 字段做 structural type guard
+        if (!raw || typeof raw !== 'object' || !('type' in raw))
+            continue;
+        const rec = raw;
+        if (rec.type === 'user') {
+            const u = rec;
+            // 检测 skill 信号 2 (slash command)
+            const cmdSkill = extractCommandSkillRef(u);
+            if (cmdSkill && !isCurrentSkillRef(cmdSkill)) {
+                startNewSegment(cmdSkill, recordIndex, u.timestamp, {
+                    source: 'command-name',
+                    confidence: 0.85,
+                    rawSkillRef: cmdSkill.rawSkillRef,
+                    pluginName: cmdSkill.pluginName,
+                    commandName: `/${cmdSkill.rawSkillRef}`,
+                });
+            }
+            else if (!cmdSkill) {
+                const aimaCmdSkill = extractAimaCmdSkillRef(u);
+                if (aimaCmdSkill && !isCurrentSkillRef(aimaCmdSkill)) {
+                    startNewSegment(aimaCmdSkill, recordIndex, u.timestamp, {
+                        source: 'aima-cmd',
+                        confidence: 0.85,
+                        rawSkillRef: aimaCmdSkill.rawSkillRef,
+                        pluginName: aimaCmdSkill.pluginName,
+                        commandName: aimaCmdSkill.rawSkillRef,
+                    });
+                }
+                else {
+                    const scriptSkill = extractSkillScriptCommandRef(u);
+                    if (scriptSkill && !isCurrentSkillRef(scriptSkill)) {
+                        startNewSegment(scriptSkill, recordIndex, u.timestamp, {
+                            source: 'skill-script',
+                            confidence: 0.75,
+                            rawSkillRef: scriptSkill.rawSkillRef,
+                            pluginName: scriptSkill.pluginName,
+                            commandName: scriptSkill.rawSkillRef,
+                        });
+                    }
+                }
+            }
+            // 处理 tool_result(回填之前的 tool_use)
+            if (typeof u.message.content !== 'string') {
+                for (const part of u.message.content) {
+                    if (part.type === 'tool_result') {
+                        const pending = pendingToolUses.get(part.tool_use_id);
+                        if (pending) {
+                            pending.toolCall.output = part.content;
+                            pending.toolCall.success = part.is_error !== true;
+                            if (part.is_error === true) {
+                                pending.segmentRef.metrics.numToolFailures += 1;
+                            }
+                            pendingToolUses.delete(part.tool_use_id);
+                        }
+                    }
+                }
+            }
+            // user text 合并到 tool turn(简化处理, 不强区分角色)
+            const textContent = extractUserText(u);
+            if (textContent) {
+                currentSegment.turns.push({ role: 'tool', content: textContent });
+                currentSegment.metrics.numTurns += 1;
+            }
+            updateSegmentTimestamp(currentSegment, u.timestamp);
+            markCurrentRecord(recordIndex);
+            continue;
+        }
+        if (rec.type === 'assistant') {
+            const a = rec;
+            // 检测 skill 信号 1 (Skill tool_use); 信号 3 (Read SKILL.md) 作 fallback。
+            // OpenClaw/AIMA 场景里一条用户消息可能包含多个业务动作(如 生成PRD + 生成Demo),
+            // 后续读取不同 SKILL.md 才是实际运行到哪个 skill 的稳定边界。
+            const skillTool = extractSkillToolUseRef(a);
+            if (skillTool && !isCurrentSkillRef(skillTool)) {
+                startNewSegment(skillTool, recordIndex, a.timestamp, {
+                    source: 'skill-tool',
+                    confidence: 0.95,
+                    rawSkillRef: skillTool.rawSkillRef,
+                    pluginName: skillTool.pluginName,
+                });
+            }
+            else if (!skillTool) {
+                const attrSkill = extractAttributionSkillRef(a);
+                if (attrSkill && !isCurrentSkillRef(attrSkill)) {
+                    startNewSegment(attrSkill, recordIndex, a.timestamp, {
+                        source: 'command-name',
+                        confidence: 0.85,
+                        rawSkillRef: attrSkill.rawSkillRef,
+                        pluginName: attrSkill.pluginName,
+                        commandName: `/${attrSkill.rawSkillRef}`,
+                    });
+                }
+                else {
+                    const scriptSkill = extractSkillScriptCommandRef(a);
+                    if (scriptSkill && !isCurrentSkillRef(scriptSkill)) {
+                        startNewSegment(scriptSkill, recordIndex, a.timestamp, {
+                            source: 'skill-script',
+                            confidence: 0.7,
+                            rawSkillRef: scriptSkill.rawSkillRef,
+                            pluginName: scriptSkill.pluginName,
+                            commandName: scriptSkill.rawSkillRef,
+                        });
+                    }
+                    else {
+                        const readSkill = extractSkillReadFileRef(a);
+                        if (readSkill && !isCurrentSkillRef(readSkill) && shouldCutOnReadSkill(session, currentSegment)) {
+                            startNewSegment(readSkill, recordIndex, a.timestamp, {
+                                source: 'read-skill-md',
+                                confidence: 0.5,
+                                rawSkillRef: readSkill.rawSkillRef,
+                                pluginName: readSkill.pluginName,
+                            });
+                        }
+                    }
+                }
+            }
+            // 提取 tool_use → ToolCallInfo(success 先标 true, 等 tool_result 回填)
+            const toolCalls = [];
+            let assistantText = '';
+            const assistantContent = Array.isArray(a.message.content) ? a.message.content : [];
+            for (const part of assistantContent) {
+                if (part.type === 'text' && part.text)
+                    assistantText += part.text;
+                if (part.type === 'tool_use' && part.id && part.name) {
+                    const tc = {
+                        tool: part.name,
+                        input: part.input ?? {},
+                        output: '',
+                        success: true,
+                        messageIndex: recordIndex,
+                        messageUuid: a.uuid,
+                        toolUseId: part.id,
+                        timestamp: a.timestamp,
+                        sourceTrace: session.sourcePath,
+                        sourceKind: session.sourceKind,
+                        traceRole: session.traceRole,
+                        traceLabel: session.traceLabel,
+                    };
+                    toolCalls.push(tc);
+                    pendingToolUses.set(part.id, { toolCall: tc, segmentRef: currentSegment });
+                }
+            }
+            if (toolCalls.length > 0 || assistantText) {
+                currentSegment.turns.push({
+                    role: 'assistant',
+                    content: assistantText,
+                    toolCalls: toolCalls.length > 0 ? toolCalls : undefined,
+                });
+                currentSegment.metrics.numTurns += 1;
+                currentSegment.toolCalls.push(...toolCalls);
+                currentSegment.metrics.numToolCalls += toolCalls.length;
+            }
+            // 累加 token usage
+            const usage = a.message.usage;
+            if (usage) {
+                currentSegment.metrics.inputTokens += usage.input_tokens ?? 0;
+                currentSegment.metrics.outputTokens += usage.output_tokens ?? 0;
+                currentSegment.metrics.cacheReadTokens += usage.cache_read_input_tokens ?? 0;
+                currentSegment.metrics.cacheCreationTokens += usage.cache_creation_input_tokens ?? 0;
+            }
+            updateSegmentTimestamp(currentSegment, a.timestamp);
+            markCurrentRecord(recordIndex);
+            continue;
+        }
+        // 其他 type(permission-mode / file-history-snapshot) 不产出事件,但仍属于当前
+        // skill 生命周期窗口,用于保持下一次 skill 边界前的连续上下文。
+        markCurrentRecord(recordIndex);
+    }
+    flushCurrent(session.records.length - 1);
+    // 孤儿 tool_use(没对应 tool_result 的)保持 success=true, 但标记为未闭合
+    return segments;
+}
+function createEmptySegment(session, skillName, index, recordIndex, timestamp, attribution) {
+    const ts = timestamp ?? session.startTimestamp ?? new Date().toISOString();
+    return {
+        skillName,
+        attribution: attribution ?? { source: 'general', confidence: 0.3 },
+        sessionId: session.sessionGroupId ?? session.sessionId,
+        traceSessionId: session.sessionId,
+        sourceTrace: session.sourcePath,
+        sourceKind: session.sourceKind,
+        traceRole: session.traceRole,
+        traceLabel: session.traceLabel,
+        segmentIndex: index,
+        startRecordIndex: recordIndex,
+        endRecordIndex: recordIndex,
+        startTimestamp: ts,
+        endTimestamp: ts,
+        cwd: session.cwd,
+        turns: [],
+        toolCalls: [],
+        metrics: {
+            durationMs: 0,
+            inputTokens: 0,
+            outputTokens: 0,
+            cacheReadTokens: 0,
+            cacheCreationTokens: 0,
+            numTurns: 0,
+            numToolCalls: 0,
+            numToolFailures: 0,
+        },
+    };
+}
+function updateSegmentTimestamp(seg, timestamp) {
+    if (!timestamp)
+        return;
+    if (!seg.endTimestamp || timestamp > seg.endTimestamp)
+        seg.endTimestamp = timestamp;
+    // 重算 durationMs
+    try {
+        const start = new Date(seg.startTimestamp).getTime();
+        const end = new Date(seg.endTimestamp).getTime();
+        if (!Number.isNaN(start) && !Number.isNaN(end))
+            seg.metrics.durationMs = Math.max(0, end - start);
+    }
+    catch { /* skip */ }
+}
+function shouldCutOnReadSkill(session, currentSegment) {
+    return currentSegment.skillName === 'general'
+        || currentSegment.attribution?.source === 'read-skill-md'
+        || session.sourceKind === 'openclaw';
+}
+function extractUserText(record) {
+    const content = record.message.content;
+    if (typeof content === 'string')
+        return stripCommandEnvelopeText(content);
+    const parts = [];
+    for (const p of content) {
+        if (p.type === 'text')
+            parts.push(stripCommandEnvelopeText(p.text));
+        if (p.type === 'tool_result' && typeof p.content === 'string')
+            parts.push(p.content);
+    }
+    return parts.join('\n');
+}
+// ---------- Segment → ResultEntry ----------
+/**
+ * SkillSegment[] → ResultEntry[] (omk 内部分析路径的标准输入)。
+ *
+ * 映射规则(详见 docs/skill-health-spec.md):
+ *   - 每 segment 一个 ResultEntry
+ *   - sample_id = `${sessionId}:${segmentIndex}`
+ *   - variant key = skill 名(复用 omk 的 variant 维度作为 skill 分组维度)
+ */
+export function segmentsToResultEntries(segments) {
+    return segments.map((seg) => ({
+        sample_id: `${seg.sessionId}:${seg.segmentIndex}`,
+        variants: {
+            [seg.skillName]: buildVariantResult(seg),
+        },
+    }));
+}
+function buildVariantResult(seg) {
+    const totalTokens = seg.metrics.inputTokens + seg.metrics.outputTokens;
+    const toolSuccessRate = seg.metrics.numToolCalls > 0
+        ? (seg.metrics.numToolCalls - seg.metrics.numToolFailures) / seg.metrics.numToolCalls
+        : 1;
+    return {
+        ok: true,
+        durationMs: seg.metrics.durationMs,
+        durationApiMs: seg.metrics.durationMs,
+        inputTokens: seg.metrics.inputTokens,
+        outputTokens: seg.metrics.outputTokens,
+        totalTokens,
+        cacheReadTokens: seg.metrics.cacheReadTokens,
+        cacheCreationTokens: seg.metrics.cacheCreationTokens,
+        execCostUSD: 0,
+        judgeCostUSD: 0,
+        costUSD: 0,
+        numTurns: seg.metrics.numTurns,
+        numToolCalls: seg.metrics.numToolCalls,
+        numToolFailures: seg.metrics.numToolFailures,
+        toolSuccessRate,
+        toolNames: Array.from(new Set(seg.toolCalls.map((tc) => tc.tool))),
+        outputPreview: null,
+        turns: seg.turns,
+        toolCalls: seg.toolCalls,
+    };
+}
+//# sourceMappingURL=trace-segmenter.js.map

package/dist/src/observability/trace-segmenter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-segmenter.js","sourceRoot":"","sources":["../../../src/observability/trace-segmenter.ts"],"names":[],"mappings":"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"}

package/dist/src/observability/trace-source.d.ts

@@ -0,0 +1,99 @@
+/** Trace source loading and parsing for Claude JSONL / OpenClaw JSONL / generic markdown logs. */
+export interface CcAssistantContent {
+    type: 'thinking' | 'text' | 'tool_use';
+    thinking?: string;
+    text?: string;
+    id?: string;
+    name?: string;
+    input?: Record<string, unknown>;
+}
+export interface CcAssistantRecord {
+    type: 'assistant';
+    uuid: string;
+    parentUuid: string | null;
+    sessionId: string;
+    timestamp: string;
+    cwd?: string;
+    gitBranch?: string;
+    entrypoint?: string;
+    attributionSkill?: string;
+    message: {
+        role: 'assistant';
+        model?: string;
+        content: CcAssistantContent[];
+        stop_reason?: string;
+        usage?: {
+            input_tokens?: number;
+            output_tokens?: number;
+            cache_read_input_tokens?: number;
+            cache_creation_input_tokens?: number;
+        };
+    };
+}
+export interface CcUserToolResultContent {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string;
+    is_error?: boolean;
+}
+export interface CcUserTextContent {
+    type: 'text';
+    text: string;
+}
+export interface CcUserRecord {
+    type: 'user';
+    uuid: string;
+    parentUuid: string | null;
+    sessionId: string;
+    timestamp: string;
+    entrypoint?: string;
+    message: {
+        role: 'user';
+        content: string | Array<CcUserTextContent | CcUserToolResultContent>;
+    };
+}
+export type CcRecord = CcAssistantRecord | CcUserRecord | {
+    type: string;
+    [k: string]: unknown;
+};
+export interface TraceSourceMetadata {
+    channel?: string;
+    sender?: string;
+    senderId?: string;
+    provider?: string;
+    model?: string;
+    modelApi?: string;
+    aimaCommands?: string[];
+}
+export interface CcSession {
+    sessionId: string;
+    /**
+     * Logical parent session. For a directory shaped as:
+     *   A/main.jsonl
+     *   A/subagents/x1.jsonl
+     *   A/subagents/x2.jsonl
+     * all three traces share the same sessionGroupId, while sourcePath still
+     * points at the concrete evidence file.
+     */
+    sessionGroupId?: string;
+    sessionGroupPath?: string;
+    traceId?: string;
+    traceRole?: 'standalone' | 'main' | 'subagent';
+    traceLabel?: string;
+    sourcePath: string;
+    sourceKind?: 'claude' | 'openclaw' | 'markdown_log' | 'unknown';
+    records: unknown[];
+    cwd?: string;
+    gitBranch?: string;
+    entrypoint?: string;
+    sourceMetadata?: TraceSourceMetadata;
+    startTimestamp?: string;
+    endTimestamp?: string;
+}
+/**
+ * 加载一个目录(或单个 JSONL/agent markdown log 文件)下的所有 session。
+ * 递归扫描目录,覆盖 Claude Code 主 session 旁边的 subagents/*.jsonl,
+ * 也支持 agent workspace/logs/*.log 里的 Markdown 对话记录。
+ */
+export declare function loadCcSessions(path: string): CcSession[];
+//# sourceMappingURL=trace-source.d.ts.map

package/dist/src/observability/trace-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-source.d.ts","sourceRoot":"","sources":["../../../src/observability/trace-source.ts"],"names":[],"mappings":"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"}