oh-my-knowledge 0.28.0 → 0.30.0

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

@@ -1,362 +1,16 @@
 /**
- * cc session JSONL → omk ResultEntry adapter (v0.18 skill-health)。
+ * cc session JSONL / agent markdown log → omk ResultEntry adapter.
  *
- * 核心职责:
- *   1. 读 cc session JSONL 文件 / 目录
- *   2. 按 session 拆分、按 skill 信号切段(见 docs/skill-health-spec.md §四)
- *   3. 每段输出为一个 ResultEntry, variant key = skill 名
- *
- * skill 归属信号(spec §四):
- *   - 信号 1: tool_use name="Skill" 的 input.skill
- *   - 信号 2: user message 里的 <command-name>/X</command-name>
- *   - 无任何信号 → 'general'(裸 cc 对话,不丢弃)
- *
- * v0.18 不处理:
- *   - Skill tool 嵌套调用(扁平切段)
- *   - 信号 3 (Read .claude/skills/X/SKILL.md,留 v0.19)
- *   - 版本对齐(全部归到 skill 名下)
- */
-import { readFileSync, readdirSync, statSync } from 'node:fs';
-import { join } from 'node:path';
-// ---------- Load ----------
-/**
- * 加载一个目录(或单个 JSONL 文件)下的所有 cc session。目录递归只一层(cc 的实际布局)。
- */
-export function loadCcSessions(path) {
-    const stat = statSync(path);
-    if (stat.isFile()) {
-        return [parseCcSessionFile(path)];
-    }
-    const entries = readdirSync(path)
-        .filter((f) => f.endsWith('.jsonl'))
-        .map((f) => join(path, f));
-    return entries.map(parseCcSessionFile).filter((s) => s !== null);
-}
-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,
-    };
-}
-// ---------- Skill signal detection ----------
-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)
+ * This file is intentionally thin: source parsing, attribution, and segmentation
+ * live in sibling modules so studio/report code does not inherit one large adapter.
  */
-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 表示没命中。
- */
-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 表示没命中。
- */
-function extractSkillToolUse(record) {
-    for (const part of record.message.content) {
-        if (part.type === 'tool_use' && part.name === 'Skill') {
-            const skill = part.input?.skill;
-            if (typeof skill === 'string')
-                return normalizeSkillName(skill);
-        }
-    }
-    return 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 表示没命中。
- */
-function extractSkillReadFile(record) {
-    for (const part of record.message.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;
-}
-// ---------- 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) => {
-        // 空段被新信号替换时,不推进 segmentIndex(保持整洁的 0-based 编号)
-        const wasNonEmpty = flushCurrent();
-        if (wasNonEmpty)
-            segmentIndex += 1;
-        currentSegment = createEmptySegment(session, skillName, segmentIndex, timestamp);
-        currentSkill = skillName;
-    };
-    for (const raw of session.records) {
-        // 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);
-            }
-            // 处理 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);
-            }
-            else if (!skillTool && currentSkill === 'general') {
-                const readSkill = extractSkillReadFile(a);
-                if (readSkill) {
-                    startNewSegment(readSkill, a.timestamp);
-                }
-            }
-            // 提取 tool_use → ToolCallInfo(success 先标 true, 等 tool_result 回填)
-            const toolCalls = [];
-            let assistantText = '';
-            for (const part of a.message.content) {
-                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,
-                    };
-                    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) {
-    const ts = timestamp ?? session.startTimestamp ?? new Date().toISOString();
-    return {
-        skillName,
-        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,
-    };
-}
-// ---------- 顶层便捷入口 ----------
+import { loadCcSessions } from './trace-source.js';
+import { segmentBySkill, segmentsToResultEntries } from './trace-segmenter.js';
+export { loadCcSessions } from './trace-source.js';
+export { extractAttributionSkill, extractAttributionSkillRef, extractCommandSkill, extractCommandSkillRef, extractCommandEnvelopeText, extractMarkdownLogSkill, extractSkillReadFileRef, extractSkillReadFile, extractSkillToolUse, extractSkillToolUseRef, normalizeSkillName, parseSkillRef, stripCommandEnvelopeText, } from './trace-attribution.js';
+export { segmentBySkill, segmentsToResultEntries } from './trace-segmenter.js';
 /**
- * 一站式:目录 → ResultEntry[]。
+ * One-stop conversion: trace path → ResultEntry[].
  */
 export function ccTracesToResultEntries(path) {
     const sessions = loadCcSessions(path);

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

@@ -1 +1 @@
-{"version":3,"file":"trace-adapter.js","sourceRoot":"","sources":["../../../src/observability/trace-adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trace-adapter.js","sourceRoot":"","sources":["../../../src/observability/trace-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,cAAc,EAAkB,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAqB,MAAM,sBAAsB,CAAC;AAWlG,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACtB,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,kBAAkB,EAClB,aAAa,EACb,wBAAwB,GACzB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/E;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAClD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AACzC,CAAC"}

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

@@ -0,0 +1,56 @@
+/** Skill attribution rules for trace records. */
+import type { CcAssistantRecord, CcUserRecord } from './trace-source.js';
+export interface SkillRef {
+    skillName: string;
+    rawSkillRef: string;
+    pluginName?: string;
+}
+export declare function extractMarkdownLogSkill(text: string): string | null;
+/**
+ * 归一化 skill 名: 去掉 plugin 前缀, 过滤 cc 内置命令。
+ * - "impeccable:audit" → "audit"
+ * - "pbakaus/impeccable:audit" → "audit"
+ * - "clear" / "exit" 等 → null(表示不是 skill)
+ */
+export declare function normalizeSkillName(raw: string): string | null;
+export declare function parseSkillRef(raw: string): SkillRef | null;
+export declare function stripCommandEnvelopeText(text: string): string;
+export declare function extractCommandEnvelopeText(text: string): string | null;
+/**
+ * 从 user message 里提取 slash-command skill 名字(信号 2)。
+ * 返回 null 表示没命中。
+ */
+export declare function extractCommandSkill(record: CcUserRecord): string | null;
+export declare function extractCommandSkillRef(record: CcUserRecord): SkillRef | null;
+/**
+ * 从 OpenClaw / AIMA user message 里提取 aima-cmd skill 名字(信号 4)。
+ *
+ * 注意: 真实 OpenClaw 数据里 name 可能是业务动作展示名, 例如 "生成PRD" / "生成Demo",
+ * 这不是稳定 skill id。只有 name 本身像 "prd-create" 这种 slug 时才用于 skill 归因;
+ * 中文动作名继续保留在 sourceMetadata.aimaCommands 里, 不切 skill。
+ */
+export declare function extractAimaCmdSkillRef(record: CcUserRecord): SkillRef | null;
+/**
+ * 从 assistant message 的 tool_use 里提取 Skill tool 调用的 skill 名字(信号 1)。
+ * 返回 null 表示没命中。
+ */
+export declare function extractSkillToolUse(record: CcAssistantRecord): string | null;
+export declare function extractSkillToolUseRef(record: CcAssistantRecord): SkillRef | null;
+export declare function extractAttributionSkill(record: CcAssistantRecord): string | null;
+export declare function extractAttributionSkillRef(record: CcAssistantRecord): SkillRef | null;
+/**
+ * 从 assistant message 的 Read tool_use 里提取 skill 名字(信号 3, fallback)。
+ * 匹配 file_path 形如 ".claude/skills/<name>/SKILL.md"
+ * 或 ".openclaw/workspace/skills/<name>/SKILL.md" 的模式。
+ * 返回 null 表示没命中。
+ */
+export declare function extractSkillReadFile(record: CcAssistantRecord): string | null;
+export declare function extractSkillReadFileRef(record: CcAssistantRecord): SkillRef | null;
+/**
+ * 从 OpenClaw cron/user 文本或 Bash/exec tool command 里提取 skill 脚本路径。
+ *
+ * cron 型 OpenClaw session 通常没有 <aima-cmd> 或 Skill tool_use,
+ * 只会直接执行 ~/.openclaw/workspace-main/skills/<skill>/scripts/*.sh。
+ */
+export declare function extractSkillScriptCommandRef(record: CcUserRecord | CcAssistantRecord): SkillRef | null;
+//# sourceMappingURL=trace-attribution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace-attribution.d.ts","sourceRoot":"","sources":["../../../src/observability/trace-attribution.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAEjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAIzE,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAenE;AAcD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAa1D;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE7D;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGtE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,GAAG,IAAI,CAEvE;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,IAAI,CAe5E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,GAAG,QAAQ,GAAG,IAAI,CAe5E;AAOD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,iBAAiB,GAAG,QAAQ,GAAG,IAAI,CASjF;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAEhF;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,iBAAiB,GAAG,QAAQ,GAAG,IAAI,CAErF;AAMD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CAE7E;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,QAAQ,GAAG,IAAI,CAYlF;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,iBAAiB,GAAG,QAAQ,GAAG,IAAI,CAoBtG"}

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

@@ -0,0 +1,200 @@
+/** Skill attribution rules for trace records. */
+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>/;
+const AIMA_CMD_RE = /<aima-cmd\b[^>]*\bname=["']([^"']+)["'][^>]*>/;
+const COMMAND_ENVELOPE_RE = /<command-(?:name|message)>[\s\S]*?<\/command-(?:name|message)>/g;
+// 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) {
+    return parseSkillRef(raw)?.skillName ?? null;
+}
+export function parseSkillRef(raw) {
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return null;
+    // plugin-prefixed: pbakaus/impeccable:audit / impeccable:audit → 取最后一段
+    const colonIdx = trimmed.lastIndexOf(':');
+    const name = colonIdx >= 0 ? trimmed.slice(colonIdx + 1) : trimmed;
+    if (CC_BUILTIN_COMMANDS.has(name))
+        return null;
+    const pluginName = colonIdx >= 0 ? trimmed.slice(0, colonIdx) : undefined;
+    return {
+        skillName: name,
+        rawSkillRef: trimmed,
+        pluginName: pluginName || undefined,
+    };
+}
+export function stripCommandEnvelopeText(text) {
+    return text.replace(COMMAND_ENVELOPE_RE, '').replace(/\n{3,}/g, '\n\n').trim();
+}
+export function extractCommandEnvelopeText(text) {
+    const matches = text.match(COMMAND_ENVELOPE_RE);
+    return matches?.join('\n') ?? null;
+}
+/**
+ * 从 user message 里提取 slash-command skill 名字(信号 2)。
+ * 返回 null 表示没命中。
+ */
+export function extractCommandSkill(record) {
+    return extractCommandSkillRef(record)?.skillName ?? null;
+}
+export function extractCommandSkillRef(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 ? parseSkillRef(raw) : null;
+}
+/**
+ * 从 OpenClaw / AIMA user message 里提取 aima-cmd skill 名字(信号 4)。
+ *
+ * 注意: 真实 OpenClaw 数据里 name 可能是业务动作展示名, 例如 "生成PRD" / "生成Demo",
+ * 这不是稳定 skill id。只有 name 本身像 "prd-create" 这种 slug 时才用于 skill 归因;
+ * 中文动作名继续保留在 sourceMetadata.aimaCommands 里, 不切 skill。
+ */
+export function extractAimaCmdSkillRef(record) {
+    const content = record.message.content;
+    let raw = null;
+    if (typeof content === 'string') {
+        const m = AIMA_CMD_RE.exec(content);
+        raw = m ? m[1] : null;
+    }
+    else {
+        for (const part of content) {
+            if (part.type === 'text') {
+                const m = AIMA_CMD_RE.exec(part.text);
+                if (m) {
+                    raw = m[1];
+                    break;
+                }
+            }
+        }
+    }
+    return raw && isStableSkillSlug(raw) ? parseSkillRef(raw) : null;
+}
+function isStableSkillSlug(raw) {
+    const trimmed = raw.trim();
+    return /^[a-zA-Z0-9][a-zA-Z0-9_.-]*$/.test(trimmed) && /[-_.]/.test(trimmed);
+}
+/**
+ * 从 assistant message 的 tool_use 里提取 Skill tool 调用的 skill 名字(信号 1)。
+ * 返回 null 表示没命中。
+ */
+export function extractSkillToolUse(record) {
+    return extractSkillToolUseRef(record)?.skillName ?? null;
+}
+export function extractSkillToolUseRef(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 parseSkillRef(skill);
+        }
+    }
+    return null;
+}
+export function extractAttributionSkill(record) {
+    return extractAttributionSkillRef(record)?.skillName ?? null;
+}
+export function extractAttributionSkillRef(record) {
+    return record.attributionSkill ? parseSkillRef(record.attributionSkill) : null;
+}
+// OpenClaw traces may point at either workspace root; both layouts store skills under <workspace>/skills.
+const SKILL_READ_FILE_RE = /(?:\.claude\/skills|\.openclaw\/workspace(?:-main)?\/skills)\/([^/]+)\/SKILL\.md$/;
+const SKILL_SCRIPT_PATH_RE = /(?:^|[\s"'`(\[{:,])(?:~|\.|\/)?[^\s"'`]*\/skills\/([^/\s"'`]+)\/scripts\/[^\s"'`]*/;
+/**
+ * 从 assistant message 的 Read tool_use 里提取 skill 名字(信号 3, fallback)。
+ * 匹配 file_path 形如 ".claude/skills/<name>/SKILL.md"
+ * 或 ".openclaw/workspace/skills/<name>/SKILL.md" 的模式。
+ * 返回 null 表示没命中。
+ */
+export function extractSkillReadFile(record) {
+    return extractSkillReadFileRef(record)?.skillName ?? null;
+}
+export function extractSkillReadFileRef(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 parseSkillRef(m[1]);
+            }
+        }
+    }
+    return null;
+}
+/**
+ * 从 OpenClaw cron/user 文本或 Bash/exec tool command 里提取 skill 脚本路径。
+ *
+ * cron 型 OpenClaw session 通常没有 <aima-cmd> 或 Skill tool_use,
+ * 只会直接执行 ~/.openclaw/workspace-main/skills/<skill>/scripts/*.sh。
+ */
+export function extractSkillScriptCommandRef(record) {
+    const texts = [];
+    const content = record.message.content;
+    if (typeof content === 'string') {
+        texts.push(content);
+    }
+    else {
+        for (const part of content) {
+            if (part.type === 'text' && typeof part.text === 'string') {
+                texts.push(part.text);
+            }
+            else if (part.type === 'tool_use') {
+                const command = part.input?.command;
+                if (typeof command === 'string')
+                    texts.push(command);
+            }
+        }
+    }
+    for (const text of texts) {
+        const match = SKILL_SCRIPT_PATH_RE.exec(text);
+        if (match?.[1])
+            return parseSkillRef(match[1]);
+    }
+    return null;
+}
+//# sourceMappingURL=trace-attribution.js.map