oh-my-knowledge 0.28.0 → 0.29.0

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

@@ -0,0 +1,104 @@
+/** Skill attribution rules for trace records. */
+// ---------- Skill signal detection ----------
+export function extractMarkdownLogSkill(text) {
+    const patterns = [
+        /\b(?:prefer|use|call|invoke)\s+`?([a-zA-Z0-9][\w.-]*)`?\s+skill\b/i,
+        /优先调用\s+`?([a-zA-Z0-9][\w.-]*)`?\s+skill/i,
+        /调用\s+`?([a-zA-Z0-9][\w.-]*)`?\s+skill/i,
+        /使用\s+`?([a-zA-Z0-9][\w.-]*)`?\s+skill/i,
+        /`([a-zA-Z0-9][\w.-]*)`\s+skill/i,
+        /\b([a-zA-Z0-9][\w.-]*-[\w.-]*)\s+skill\b/i,
+    ];
+    for (const pattern of patterns) {
+        const match = text.match(pattern);
+        const normalized = match?.[1] ? normalizeSkillName(match[1]) : null;
+        if (normalized)
+            return normalized;
+    }
+    return null;
+}
+const COMMAND_NAME_RE = /<command-name>\/([^<]+)<\/command-name>/;
+// cc 内置 CLI 命令(不是 skill)。dogfood 数据中这些词频繁以 <command-name> 出现,
+// 必须过滤掉才能得到真实 skill 分布。列表基于实测 + cc 常规命令集。
+const CC_BUILTIN_COMMANDS = new Set([
+    'clear', 'exit', 'quit', 'help', 'fast', 'effort', 'model',
+    'plugin', 'stats', 'doctor', 'compact', 'cost', 'agents', 'init',
+    'config', 'permissions', 'resume', 'continue', 'memory',
+]);
+/**
+ * 归一化 skill 名: 去掉 plugin 前缀, 过滤 cc 内置命令。
+ * - "impeccable:audit" → "audit"
+ * - "pbakaus/impeccable:audit" → "audit"
+ * - "clear" / "exit" 等 → null(表示不是 skill)
+ */
+export function normalizeSkillName(raw) {
+    // plugin-prefixed: pbakaus/impeccable:audit / impeccable:audit → 取最后一段
+    const colonIdx = raw.lastIndexOf(':');
+    const name = colonIdx >= 0 ? raw.slice(colonIdx + 1) : raw;
+    if (CC_BUILTIN_COMMANDS.has(name))
+        return null;
+    return name;
+}
+/**
+ * 从 user message 里提取 slash-command skill 名字(信号 2)。
+ * 返回 null 表示没命中。
+ */
+export function extractCommandSkill(record) {
+    const content = record.message.content;
+    let raw = null;
+    if (typeof content === 'string') {
+        const m = COMMAND_NAME_RE.exec(content);
+        raw = m ? m[1] : null;
+    }
+    else {
+        for (const part of content) {
+            if (part.type === 'text') {
+                const m = COMMAND_NAME_RE.exec(part.text);
+                if (m) {
+                    raw = m[1];
+                    break;
+                }
+            }
+        }
+    }
+    return raw ? normalizeSkillName(raw) : null;
+}
+/**
+ * 从 assistant message 的 tool_use 里提取 Skill tool 调用的 skill 名字(信号 1)。
+ * 返回 null 表示没命中。
+ */
+export function extractSkillToolUse(record) {
+    const content = Array.isArray(record.message.content) ? record.message.content : [];
+    for (const part of content) {
+        if (part.type === 'tool_use' && part.name === 'Skill') {
+            const skill = part.input?.skill;
+            if (typeof skill === 'string')
+                return normalizeSkillName(skill);
+        }
+    }
+    return null;
+}
+export function extractAttributionSkill(record) {
+    return record.attributionSkill ? normalizeSkillName(record.attributionSkill) : null;
+}
+const SKILL_READ_FILE_RE = /\.claude\/skills\/([^/]+)\/SKILL\.md$/;
+/**
+ * 从 assistant message 的 Read tool_use 里提取 skill 名字(信号 3, fallback)。
+ * 匹配 file_path 形如 ".claude/skills/<name>/SKILL.md" 的模式。
+ * 返回 null 表示没命中。
+ */
+export function extractSkillReadFile(record) {
+    const content = Array.isArray(record.message.content) ? record.message.content : [];
+    for (const part of content) {
+        if (part.type === 'tool_use' && part.name === 'Read') {
+            const filePath = part.input?.file_path;
+            if (typeof filePath === 'string') {
+                const m = SKILL_READ_FILE_RE.exec(filePath);
+                if (m)
+                    return normalizeSkillName(m[1]);
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=trace-attribution.js.map

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":"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"}

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

@@ -0,0 +1,42 @@
+/** 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' | 'read-skill-md' | 'general';
+        confidence: number;
+    };
+    sessionId: string;
+    segmentIndex: 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;AAGpF,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE;QACZ,MAAM,EAAE,YAAY,GAAG,cAAc,GAAG,eAAe,GAAG,SAAS,CAAC;QACpE,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,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+HjE;AAmDD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,CAO/E"}

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

@@ -0,0 +1,231 @@
+/** Skill segmentation and ResultEntry projection for loaded traces. */
+import { extractAttributionSkill, extractCommandSkill, extractSkillReadFile, extractSkillToolUse } 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 currentSegment = createEmptySegment(session, currentSkill, 0);
+    let segmentIndex = 0;
+    // 用 tool_use_id → ToolCallInfo 的映射, 收到 tool_result 时回填 output / success
+    const pendingToolUses = new Map();
+    const flushCurrent = () => {
+        if (currentSegment.turns.length > 0 || currentSegment.toolCalls.length > 0) {
+            segments.push(currentSegment);
+            return true;
+        }
+        return false;
+    };
+    const startNewSegment = (skillName, timestamp, attribution) => {
+        // 空段被新信号替换时,不推进 segmentIndex(保持整洁的 0-based 编号)
+        const wasNonEmpty = flushCurrent();
+        if (wasNonEmpty)
+            segmentIndex += 1;
+        currentSegment = createEmptySegment(session, skillName, segmentIndex, timestamp, attribution);
+        currentSkill = skillName;
+    };
+    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 = extractCommandSkill(u);
+            if (cmdSkill && cmdSkill !== currentSkill) {
+                startNewSegment(cmdSkill, u.timestamp, { source: 'command-name', confidence: 0.85 });
+            }
+            // 处理 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);
+            continue;
+        }
+        if (rec.type === 'assistant') {
+            const a = rec;
+            // 检测 skill 信号 1 (Skill tool_use); 信号 3 (Read SKILL.md) 作 fallback,
+            // 仅在当前段仍是 'general'(未被信号 1/2 命中过)时触发,避免压过更强信号。
+            const skillTool = extractSkillToolUse(a);
+            if (skillTool && skillTool !== currentSkill) {
+                startNewSegment(skillTool, a.timestamp, { source: 'skill-tool', confidence: 0.95 });
+            }
+            else if (!skillTool) {
+                const attrSkill = extractAttributionSkill(a);
+                if (attrSkill && attrSkill !== currentSkill) {
+                    startNewSegment(attrSkill, a.timestamp, { source: 'command-name', confidence: 0.85 });
+                }
+                else if (currentSkill === 'general') {
+                    const readSkill = extractSkillReadFile(a);
+                    if (readSkill) {
+                        startNewSegment(readSkill, a.timestamp, { source: 'read-skill-md', confidence: 0.5 });
+                    }
+                }
+            }
+            // 提取 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,
+                    };
+                    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);
+            continue;
+        }
+        // 其他 type(permission-mode / file-history-snapshot) 直接 skip
+    }
+    flushCurrent();
+    // 孤儿 tool_use(没对应 tool_result 的)保持 success=true, 但标记为未闭合
+    return segments;
+}
+function createEmptySegment(session, skillName, index, timestamp, attribution) {
+    const ts = timestamp ?? session.startTimestamp ?? new Date().toISOString();
+    return {
+        skillName,
+        attribution: attribution ?? { source: 'general', confidence: 0.3 },
+        sessionId: session.sessionId,
+        segmentIndex: index,
+        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 extractUserText(record) {
+    const content = record.message.content;
+    if (typeof content === 'string')
+        return content;
+    const parts = [];
+    for (const p of content) {
+        if (p.type === 'text')
+            parts.push(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":"AAAA,uEAAuE;AAIvE,OAAO,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AA2BjI,yCAAyC;AAEzC;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,OAAkB;IAC/C,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,IAAI,YAAY,GAAG,SAAS,CAAC;IAC7B,IAAI,cAAc,GAAG,kBAAkB,CAAC,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;IAClE,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,wEAAwE;IACxE,MAAM,eAAe,GAAG,IAAI,GAAG,EAAgE,CAAC;IAEhG,MAAM,YAAY,GAAG,GAAY,EAAE;QACjC,IAAI,cAAc,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,cAAc,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3E,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAC9B,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;IAEF,MAAM,eAAe,GAAG,CAAC,SAAiB,EAAE,SAAkB,EAAE,WAAyC,EAAQ,EAAE;QACjH,+CAA+C;QAC/C,MAAM,WAAW,GAAG,YAAY,EAAE,CAAC;QACnC,IAAI,WAAW;YAAE,YAAY,IAAI,CAAC,CAAC;QACnC,cAAc,GAAG,kBAAkB,CAAC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;QAC9F,YAAY,GAAG,SAAS,CAAC;IAC3B,CAAC,CAAC;IAEF,KAAK,MAAM,CAAC,WAAW,EAAE,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3D,wDAAwD;QACxD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC;YAAE,SAAS;QAClE,MAAM,GAAG,GAAG,GAAuB,CAAC;QACpC,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,GAAmB,CAAC;YAC9B,gCAAgC;YAChC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;YACxC,IAAI,QAAQ,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;gBAC1C,eAAe,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YACvF,CAAC;YACD,iCAAiC;YACjC,IAAI,OAAO,CAAC,CAAC,OAAO,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC1C,KAAK,MAAM,IAAI,IAAI,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;oBACrC,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,EAAE,CAAC;wBAChC,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;wBACtD,IAAI,OAAO,EAAE,CAAC;4BACZ,OAAO,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC;4BACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC;4BAClD,IAAI,IAAI,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;gCAC3B,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,eAAe,IAAI,CAAC,CAAC;4BAClD,CAAC;4BACD,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;wBAC3C,CAAC;oBACH,CAAC;gBACH,CAAC;YACH,CAAC;YACD,wCAAwC;YACxC,MAAM,WAAW,GAAG,eAAe,CAAC,CAAC,CAAC,CAAC;YACvC,IAAI,WAAW,EAAE,CAAC;gBAChB,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;gBAClE,cAAc,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;YACvC,CAAC;YACD,sBAAsB,CAAC,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;YACpD,SAAS;QACX,CAAC;QACD,IAAI,GAAG,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,GAAwB,CAAC;YACnC,mEAAmE;YACnE,+CAA+C;YAC/C,MAAM,SAAS,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAAC;YACzC,IAAI,SAAS,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;gBAC5C,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YACtF,CAAC;iBAAM,IAAI,CAAC,SAAS,EAAE,CAAC;gBACtB,MAAM,SAAS,GAAG,uBAAuB,CAAC,CAAC,CAAC,CAAC;gBAC7C,IAAI,SAAS,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;oBAC5C,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;gBACxF,CAAC;qBAAM,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;oBACtC,MAAM,SAAS,GAAG,oBAAoB,CAAC,CAAC,CAAC,CAAC;oBAC1C,IAAI,SAAS,EAAE,CAAC;wBACd,eAAe,CAAC,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;oBACxF,CAAC;gBACH,CAAC;YACH,CAAC;YACD,gEAAgE;YAChE,MAAM,SAAS,GAAmB,EAAE,CAAC;YACrC,IAAI,aAAa,GAAG,EAAE,CAAC;YACvB,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YACnF,KAAK,MAAM,IAAI,IAAI,gBAAgB,EAAE,CAAC;gBACpC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI;oBAAE,aAAa,IAAI,IAAI,CAAC,IAAI,CAAC;gBAClE,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;oBACrD,MAAM,EAAE,GAAiB;wBACvB,IAAI,EAAE,IAAI,CAAC,IAAI;wBACf,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;wBACvB,MAAM,EAAE,EAAE;wBACV,OAAO,EAAE,IAAI;wBACb,YAAY,EAAE,WAAW;wBACzB,WAAW,EAAE,CAAC,CAAC,IAAI;wBACnB,SAAS,EAAE,IAAI,CAAC,EAAE;wBAClB,SAAS,EAAE,CAAC,CAAC,SAAS;qBACvB,CAAC;oBACF,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;oBACnB,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC;gBAC7E,CAAC;YACH,CAAC;YACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,IAAI,aAAa,EAAE,CAAC;gBAC1C,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC;oBACxB,IAAI,EAAE,WAAW;oBACjB,OAAO,EAAE,aAAa;oBACtB,SAAS,EAAE,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;iBACxD,CAAC,CAAC;gBACH,cAAc,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC;gBACrC,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAC;gBAC5C,cAAc,CAAC,OAAO,CAAC,YAAY,IAAI,SAAS,CAAC,MAAM,CAAC;YAC1D,CAAC;YACD,iBAAiB;YACjB,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;YAC9B,IAAI,KAAK,EAAE,CAAC;gBACV,cAAc,CAAC,OAAO,CAAC,WAAW,IAAI,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;gBAC9D,cAAc,CAAC,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC;gBAChE,cAAc,CAAC,OAAO,CAAC,eAAe,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,CAAC;gBAC7E,cAAc,CAAC,OAAO,CAAC,mBAAmB,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,CAAC;YACvF,CAAC;YACD,sBAAsB,CAAC,cAAc,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC;YACpD,SAAS;QACX,CAAC;QACD,2DAA2D;IAC7D,CAAC;IAED,YAAY,EAAE,CAAC;IACf,yDAAyD;IACzD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,kBAAkB,CAAC,OAAkB,EAAE,SAAiB,EAAE,KAAa,EAAE,SAAkB,EAAE,WAAyC;IAC7I,MAAM,EAAE,GAAG,SAAS,IAAI,OAAO,CAAC,cAAc,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3E,OAAO;QACL,SAAS;QACT,WAAW,EAAE,WAAW,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,EAAE;QAClE,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,YAAY,EAAE,KAAK;QACnB,cAAc,EAAE,EAAE;QAClB,YAAY,EAAE,EAAE;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,EAAE;QACT,SAAS,EAAE,EAAE;QACb,OAAO,EAAE;YACP,UAAU,EAAE,CAAC;YACb,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,CAAC;YACf,eAAe,EAAE,CAAC;YAClB,mBAAmB,EAAE,CAAC;YACtB,QAAQ,EAAE,CAAC;YACX,YAAY,EAAE,CAAC;YACf,eAAe,EAAE,CAAC;SACnB;KACF,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,GAAiB,EAAE,SAAkB;IACnE,IAAI,CAAC,SAAS;QAAE,OAAO;IACvB,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,SAAS,GAAG,GAAG,CAAC,YAAY;QAAE,GAAG,CAAC,YAAY,GAAG,SAAS,CAAC;IACpF,gBAAgB;IAChB,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE,CAAC;QACrD,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;QACjD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;YAAE,GAAG,CAAC,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,CAAC;IACpG,CAAC;IAAC,MAAM,CAAC,CAAC,UAAU,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,eAAe,CAAC,MAAoB;IAC3C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IACvC,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,OAAO,CAAC;IAChD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,CAAC,CAAC,IAAI,KAAK,aAAa,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACvF,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,8CAA8C;AAE9C;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAwB;IAC9D,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,GAAG,EAAe,EAAE,CAAC,CAAC;QACzC,SAAS,EAAE,GAAG,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,YAAY,EAAE;QACjD,QAAQ,EAAE;YACR,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC,GAAG,CAAC;SACzC;KACF,CAAC,CAAC,CAAC;AACN,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAiB;IAC3C,MAAM,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC;IACvE,MAAM,eAAe,GAAG,GAAG,CAAC,OAAO,CAAC,YAAY,GAAG,CAAC;QAClD,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,YAAY;QACrF,CAAC,CAAC,CAAC,CAAC;IACN,OAAO;QACL,EAAE,EAAE,IAAI;QACR,UAAU,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU;QAClC,aAAa,EAAE,GAAG,CAAC,OAAO,CAAC,UAAU;QACrC,WAAW,EAAE,GAAG,CAAC,OAAO,CAAC,WAAW;QACpC,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,YAAY;QACtC,WAAW;QACX,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,eAAe;QAC5C,mBAAmB,EAAE,GAAG,CAAC,OAAO,CAAC,mBAAmB;QACpD,WAAW,EAAE,CAAC;QACd,YAAY,EAAE,CAAC;QACf,OAAO,EAAE,CAAC;QACV,QAAQ,EAAE,GAAG,CAAC,OAAO,CAAC,QAAQ;QAC9B,YAAY,EAAE,GAAG,CAAC,OAAO,CAAC,YAAY;QACtC,eAAe,EAAE,GAAG,CAAC,OAAO,CAAC,eAAe;QAC5C,eAAe;QACf,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;QAClE,aAAa,EAAE,IAAI;QACnB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,72 @@
+/** Trace source loading and parsing for Claude 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;
+    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;
+    message: {
+        role: 'user';
+        content: string | Array<CcUserTextContent | CcUserToolResultContent>;
+    };
+}
+export type CcRecord = CcAssistantRecord | CcUserRecord | {
+    type: string;
+    [k: string]: unknown;
+};
+export interface CcSession {
+    sessionId: string;
+    sourcePath: string;
+    records: unknown[];
+    cwd?: string;
+    gitBranch?: string;
+    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":"AAAA,iFAAiF;AAQjF,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE;QACP,IAAI,EAAE,WAAW,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,kBAAkB,EAAE,CAAC;QAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE;YACN,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,aAAa,CAAC,EAAE,MAAM,CAAC;YACvB,uBAAuB,CAAC,EAAE,MAAM,CAAC;YACjC,2BAA2B,CAAC,EAAE,MAAM,CAAC;SACtC,CAAC;KACH,CAAC;CACH;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,GAAG,KAAK,CAAC,iBAAiB,GAAG,uBAAuB,CAAC,CAAC;KACtE,CAAC;CACH;AAED,MAAM,MAAM,QAAQ,GAAG,iBAAiB,GAAG,YAAY,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAIjG,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IAInB,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CAOxD"}

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

@@ -0,0 +1,142 @@
+/** Trace source loading and parsing for Claude JSONL / generic markdown logs. */
+import { readFileSync, readdirSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+import { extractMarkdownLogSkill } from './trace-attribution.js';
+// ---------- Load ----------
+/**
+ * 加载一个目录(或单个 JSONL/agent markdown log 文件)下的所有 session。
+ * 递归扫描目录,覆盖 Claude Code 主 session 旁边的 subagents/*.jsonl,
+ * 也支持 agent workspace/logs/*.log 里的 Markdown 对话记录。
+ */
+export function loadCcSessions(path) {
+    const stat = statSync(path);
+    if (stat.isFile()) {
+        return parseTraceFile(path);
+    }
+    const entries = collectTraceFiles(path);
+    return entries.flatMap(parseTraceFile);
+}
+function collectTraceFiles(dir) {
+    const files = [];
+    for (const entry of readdirSync(dir)) {
+        if (entry === 'node_modules' || entry === '.git')
+            continue;
+        const entryPath = join(dir, entry);
+        let stat;
+        try {
+            stat = statSync(entryPath);
+        }
+        catch {
+            continue;
+        }
+        if (stat.isDirectory()) {
+            files.push(...collectTraceFiles(entryPath));
+        }
+        else if (entry.endsWith('.jsonl') || entry.endsWith('.log')) {
+            files.push(entryPath);
+        }
+    }
+    return files.sort();
+}
+function parseTraceFile(filePath) {
+    if (filePath.endsWith('.jsonl'))
+        return [parseCcSessionFile(filePath)];
+    if (filePath.endsWith('.log'))
+        return parseMarkdownLogFile(filePath);
+    return [];
+}
+function parseCcSessionFile(filePath) {
+    const content = readFileSync(filePath, 'utf-8');
+    const records = [];
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            records.push(JSON.parse(trimmed));
+        }
+        catch {
+            // malformed line → skip. cc 有罕见的截断 record, 不让单行 fail 整个 session
+        }
+    }
+    const first = records.find((r) => 'sessionId' in r && typeof r.sessionId === 'string');
+    const last = [...records].reverse().find((r) => 'timestamp' in r && typeof r.timestamp === 'string');
+    return {
+        sessionId: first?.sessionId ?? filePath.split('/').pop().replace('.jsonl', ''),
+        sourcePath: filePath,
+        records,
+        cwd: first?.cwd,
+        gitBranch: first?.gitBranch,
+        startTimestamp: first?.timestamp,
+        endTimestamp: last?.timestamp,
+    };
+}
+const MARKDOWN_LOG_BLOCK_RE = /(?:^|\n)---\s*\n## \[([^\]]+)\] 对话记录[^\n]*\n([\s\S]*?)(?=\n---\s*\n## \[|$)/g;
+function parseMarkdownLogFile(filePath) {
+    const content = readFileSync(filePath, 'utf-8');
+    if (!content.includes('### 用户输入') || !content.includes('### AI 回复'))
+        return [];
+    const sessions = [];
+    let index = 0;
+    for (const match of content.matchAll(MARKDOWN_LOG_BLOCK_RE)) {
+        const timestamp = markdownLogTimestampToIso(match[1]);
+        const body = match[2] ?? '';
+        const blockCwd = body.match(/^\*\*工作目录\*\*:\s*(.+)$/m)?.[1]?.trim();
+        const blockSessionId = body.match(/^\*\*会话 ID\*\*:\s*(.+)$/m)?.[1]?.trim();
+        const requestId = body.match(/^\*\*请求 ID\*\*:\s*(.+)$/m)?.[1]?.trim() ?? String(index);
+        const userText = extractMarkdownLogSection(body, '### 用户输入', '### AI 回复');
+        const assistantText = extractMarkdownLogSection(body, '### AI 回复');
+        if (!userText && !assistantText)
+            continue;
+        const sessionId = blockSessionId || `${filePath.split('/').pop().replace(/\.log$/, '')}:${requestId}`;
+        const cwd = blockCwd;
+        const skill = extractMarkdownLogSkill(`${userText}\n${assistantText}`);
+        const userContent = skill ? `<command-name>/${skill}</command-name>\n${userText}` : userText;
+        const records = [{
+                type: 'user',
+                uuid: `markdown-log-${requestId}-user-${index}`,
+                parentUuid: null,
+                sessionId,
+                timestamp,
+                message: { role: 'user', content: userContent },
+            }, {
+                type: 'assistant',
+                uuid: `markdown-log-${requestId}-assistant-${index}`,
+                parentUuid: `markdown-log-${requestId}-user-${index}`,
+                sessionId,
+                timestamp,
+                cwd,
+                attributionSkill: skill,
+                message: {
+                    role: 'assistant',
+                    content: assistantText ? [{ type: 'text', text: assistantText }] : [],
+                    stop_reason: 'end_turn',
+                },
+            }];
+        sessions.push({
+            sessionId,
+            sourcePath: filePath,
+            records,
+            cwd,
+            startTimestamp: timestamp,
+            endTimestamp: timestamp,
+        });
+        index += 1;
+    }
+    return sessions;
+}
+function markdownLogTimestampToIso(value) {
+    const m = value.match(/^(\d{4})\/(\d{2})\/(\d{2})\s+(\d{2}):(\d{2}):(\d{2})$/);
+    if (!m)
+        return new Date().toISOString();
+    return `${m[1]}-${m[2]}-${m[3]}T${m[4]}:${m[5]}:${m[6]}+08:00`;
+}
+function extractMarkdownLogSection(body, startMarker, endMarker) {
+    const start = body.indexOf(startMarker);
+    if (start < 0)
+        return '';
+    const from = start + startMarker.length;
+    const end = endMarker ? body.indexOf(endMarker, from) : -1;
+    return body.slice(from, end >= 0 ? end : undefined).trim();
+}
+//# sourceMappingURL=trace-source.js.map

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

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

package/dist/src/renderer/html-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"html-renderer.d.ts","sourceRoot":"","sources":["../../../src/renderer/html-renderer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAmBH,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAA8B,MAAM,EAAE,cAAc,EAAE,IAAI,EAAkB,MAAM,mBAAmB,CAAC;AAmH3J,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,IAAI,GAAE,IAAmB,GAAG,MAAM,CAgMvF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,EAAE,IAAI,GAAE,IAAmB,GAAG,MAAM,CA2KlG;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,EAAE,IAAI,GAAE,IAAmB,GAAG,MAAM,CAiFnH;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,EAAE,IAAI,GAAE,IAAmB,GAAG,MAAM,CAK3G;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,IAAmB,GAAG,MAAM,CAGvG"}
+{"version":3,"file":"html-renderer.d.ts","sourceRoot":"","sources":["../../../src/renderer/html-renderer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAkBH,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAA8B,MAAM,EAAE,cAAc,EAAE,IAAI,EAAkB,MAAM,mBAAmB,CAAC;AAqI3J,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,IAAI,GAAE,IAAmB,GAAG,MAAM,CAiMvF;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,EAAE,IAAI,GAAE,IAAmB,GAAG,MAAM,CA8LlG;AAED,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,qBAAqB,GAAG,IAAI,EAAE,IAAI,GAAE,IAAmB,GAAG,MAAM,CAqFnH;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,EAAE,IAAI,GAAE,IAAmB,GAAG,MAAM,CAK3G;AAED,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,IAAmB,GAAG,MAAM,CAGvG"}