oh-my-knowledge 0.0.1 → 0.18.0

package/dist/src/inputs/url-fetcher.js

@@ -0,0 +1,241 @@
+/**
+ * URL content fetcher for eval-samples.
+ *
+ * Scans sample prompts/contexts for URLs, fetches their content,
+ * and inlines the text back into the sample fields.
+ *
+ * If a URL requires authentication, ensure the CLI environment can access it
+ * (e.g., via VPN, proxy, cookies) before running the evaluation.
+ */
+// Match URLs using RFC 3986 allowed characters (whitelist approach).
+// This avoids accidentally consuming CJK characters or punctuation adjacent to URLs.
+const URL_REGEX = /https?:\/\/[A-Za-z0-9\-._~:/?#[\]@!$&'()*+,;=%]+/g;
+const FETCH_TIMEOUT_MS = 30_000;
+// RFC 2606 / IANA reserved placeholder domains — these are documentation-only
+// and should never be fetched (they don't resolve to real services).
+const PLACEHOLDER_DOMAIN_REGEX = /^https?:\/\/(?:[^/]+\.)?(?:example\.(?:com|org|net)|localhost|test|invalid|example)(?::\d+)?(?:[/?#]|$)/i;
+export function isPlaceholderUrl(url) {
+    return PLACEHOLDER_DOMAIN_REGEX.test(url);
+}
+function asNetworkError(err) {
+    return typeof err === 'object' && err !== null ? err : {};
+}
+/**
+ * Resolve all URLs found in sample prompts and contexts.
+ * Mutates samples in-place: each URL is replaced with URL + fetched content.
+ *
+ * @param skipUrls - URLs already resolved (e.g. by MCP), will be skipped
+ */
+export async function resolveUrls(samples, skipUrls) {
+    // 1. Collect all unique URLs across all samples, tracking which sample they belong to
+    const urlMap = new Map(); // url -> [{sample, field}]
+    for (const sample of samples) {
+        for (const field of ['prompt', 'context']) {
+            const text = sample[field];
+            if (!text)
+                continue;
+            const matches = text.match(URL_REGEX);
+            if (!matches)
+                continue;
+            for (const url of matches) {
+                if (skipUrls?.has(url))
+                    continue;
+                if (isPlaceholderUrl(url))
+                    continue; // RFC 2606 placeholder domains are documentation-only
+                if (!urlMap.has(url))
+                    urlMap.set(url, []);
+                urlMap.get(url).push({ sample, field });
+            }
+        }
+    }
+    if (urlMap.size === 0)
+        return;
+    // 2. Fetch all unique URLs concurrently
+    const fetched = new Map(); // url -> { ok, content, error }
+    const entries = [...urlMap.keys()];
+    process.stderr.write(`ℹ 检测到 ${entries.length} 个 URL，正在获取内容:\n`);
+    for (const url of entries) {
+        process.stderr.write(`    - ${url}\n`);
+    }
+    const results = await Promise.allSettled(entries.map((url) => fetchUrl(url)));
+    for (let i = 0; i < entries.length; i++) {
+        const url = entries[i];
+        const result = results[i];
+        if (result.status === 'fulfilled') {
+            fetched.set(url, result.value);
+        }
+        else {
+            fetched.set(url, { ok: false, error: result.reason.message || 'unknown error' });
+        }
+    }
+    // 3. Warn about failures, inline successes
+    for (const [url, result] of fetched) {
+        if (!result.ok) {
+            const affectedSamples = urlMap.get(url).map((r) => r.sample.sample_id);
+            const unique = [...new Set(affectedSamples)];
+            process.stderr.write(`\n${formatError(url, result, unique)}\n`);
+        }
+    }
+    const failCount = [...fetched.values()].filter((r) => !r.ok).length;
+    if (failCount > 0) {
+        process.stderr.write(`\n⚠ ${failCount} 个 URL 抓取失败，将使用原始 URL 继续评测\n\n`);
+    }
+    // 4. Inline fetched content into samples (only successful ones)
+    for (const [url, result] of fetched) {
+        if (!result.ok)
+            continue;
+        const replacement = `${url}\n\n---\n${result.content}\n---`;
+        for (const { sample, field } of urlMap.get(url)) {
+            const current = sample[field];
+            if (typeof current === 'string') {
+                sample[field] = current.replace(url, replacement);
+            }
+        }
+    }
+}
+/**
+ * Fetch a single URL and return its text content.
+ */
+async function fetchUrl(url) {
+    let response;
+    try {
+        response = await fetch(url, {
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+            headers: {
+                'User-Agent': 'oh-my-knowledge/url-fetcher',
+                'Accept': 'text/html, text/plain, */*',
+            },
+            redirect: 'follow',
+        });
+    }
+    catch (err) {
+        return {
+            ok: false,
+            statusCode: 0,
+            error: networkErrorMessage(err),
+        };
+    }
+    if (!response.ok) {
+        return {
+            ok: false,
+            statusCode: response.status,
+            error: `${response.status} ${response.statusText}`,
+        };
+    }
+    const contentType = response.headers.get('content-type') || '';
+    const raw = await response.text();
+    const content = contentType.includes('text/html')
+        ? htmlToText(raw)
+        : raw.trim();
+    // Detect login/redirect pages that return 200 but no real content
+    const loginHint = detectLoginPage(content);
+    if (loginHint) {
+        return {
+            ok: false,
+            statusCode: 200,
+            error: `页面返回了登录/跳转页而非实际内容 (${loginHint})`,
+            isLoginPage: true,
+        };
+    }
+    return { ok: true, content };
+}
+/**
+ * Strip HTML tags to extract readable text.
+ */
+function htmlToText(html) {
+    return html
+        // Remove script/style blocks
+        .replace(/<script[\s\S]*?<\/script>/gi, '')
+        .replace(/<style[\s\S]*?<\/style>/gi, '')
+        // Replace block-level tags with newlines
+        .replace(/<\/(p|div|h[1-6]|li|tr|blockquote)>/gi, '\n')
+        .replace(/<br\s*\/?>/gi, '\n')
+        // Remove all remaining tags
+        .replace(/<[^>]+>/g, '')
+        // Decode common HTML entities
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&nbsp;/g, ' ')
+        // Clean up whitespace
+        .replace(/[ \t]+/g, ' ')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+/**
+ * Detect login/auth redirect pages that return HTTP 200 but no real content.
+ * Returns a hint string if detected, null otherwise.
+ */
+function detectLoginPage(content) {
+    if (content.length < 50)
+        return '内容过短';
+    const lower = content.toLowerCase();
+    const loginPatterns = [
+        'login', 'sign in', 'sign_in', 'sso', 'redirect_uri',
+        'oauth', 'unauthorized', 'cas/login',
+    ];
+    for (const pattern of loginPatterns) {
+        if (lower.includes(pattern) && content.length < 500) {
+            return pattern;
+        }
+    }
+    return null;
+}
+/**
+ * Map network errors to user-friendly messages.
+ */
+function networkErrorMessage(err) {
+    const details = asNetworkError(err);
+    const code = details.cause?.code || details.code || '';
+    if (code === 'ENOTFOUND')
+        return '域名无法解析，请检查 URL 是否正确';
+    if (code === 'ECONNREFUSED')
+        return '连接被拒绝，请检查网络或代理配置';
+    if (code === 'ECONNRESET')
+        return '连接被重置，请检查网络';
+    if (details.name === 'TimeoutError' || code === 'ABORT_ERR')
+        return `请求超时 (${FETCH_TIMEOUT_MS / 1000}s)`;
+    return details.message || 'unknown network error';
+}
+/**
+ * Format a fetch error with actionable solution.
+ */
+function formatError(url, result, sampleIds) {
+    const sampleLabel = sampleIds.map((id) => `"${id}"`).join(', ');
+    const lines = [
+        `✗ sample ${sampleLabel}: URL 无法访问`,
+        `  URL: ${url}`,
+    ];
+    if (result.statusCode) {
+        lines.push(`  状态: ${result.error}`);
+    }
+    else {
+        lines.push(`  错误: ${result.error}`);
+    }
+    lines.push(`  解决方案: ${getSolution(result.statusCode, result)}`);
+    return lines.join('\n');
+}
+/**
+ * Map HTTP status code to actionable solution text.
+ */
+function getSolution(statusCode, result) {
+    if (result?.isLoginPage) {
+        return '该链接需要认证，请确保命令行环境可正常访问（如配置 VPN/代理/cookie），或将文档内容复制到 eval-samples 的 context 字段中';
+    }
+    if (statusCode === 401 || statusCode === 403) {
+        return '该链接需要认证，请确保命令行环境可正常访问，或将文档内容复制到 eval-samples 的 context 字段中';
+    }
+    if (statusCode === 404) {
+        return '页面不存在，请检查链接是否正确';
+    }
+    if (statusCode && statusCode >= 500) {
+        return '服务端错误，请稍后重试';
+    }
+    if (!statusCode) {
+        return '无法连接目标服务，请检查网络或代理配置，或将文档内容复制到 eval-samples 的 context 字段中';
+    }
+    return '请将文档内容复制到 eval-samples 的 context 字段中';
+}
+//# sourceMappingURL=url-fetcher.js.map

package/dist/src/inputs/url-fetcher.js.map

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

package/dist/src/observability/production-analyzer.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Production analyzer (v0.18 skill-health).
+ *
+ * 接 trace-adapter 输出 → 按 skill 维度聚合 coverage + gap,产出 SkillHealthReport。
+ * 复用 analysis/coverage-analyzer + analysis/gap-analyzer,跳过对照组逻辑。
+ *
+ * 分析流水线:
+ *   1. ccTracesToResultEntries(path) → segments + ResultEntry[]
+ *   2. 时间窗 / skill 白名单过滤
+ *   3. 按 skill name (variant key) 分别 computeCoverage + computeGapReport
+ *   4. 聚合 overall 指标 + 健康度色带
+ */
+import { type CoverageReport } from '../analysis/coverage-analyzer.js';
+import type { GapReport } from '../types.js';
+import { type CcSession, type SkillSegment } from './trace-adapter.js';
+export interface SkillHealth {
+    skillName: string;
+    segmentCount: number;
+    toolCallCount: number;
+    toolFailureCount: number;
+    coverage: CoverageReport | null;
+    gap: GapReport;
+}
+export interface SkillHealthReport {
+    meta: {
+        tracePath: string;
+        kbPath: string | null;
+        sessionCount: number;
+        segmentCount: number;
+        messageCount: number;
+        toolCallCount: number;
+        toolFailureRate: number;
+        timeRange: {
+            from: string;
+            to: string;
+        };
+        generatedAt: string;
+    };
+    bySkill: Record<string, SkillHealth>;
+    overall: {
+        gapRate: number;
+        weightedGapRate: number;
+        healthBand: 'green' | 'yellow' | 'red';
+    };
+}
+export interface AnalyzeOptions {
+    kbRoot?: string | null;
+    from?: string;
+    to?: string;
+    skills?: string[];
+}
+/**
+ * 主入口:从 cc trace 目录生成 SkillHealthReport。
+ */
+export declare function computeSkillHealthReport(tracePath: string, opts?: AnalyzeOptions): SkillHealthReport;
+/**
+ * 便利入口:直接从已准备好的 segments(跳过 loadCcSessions)算 report。
+ * 用于测试 / 已手工组装过 segments 的场景。
+ */
+export declare function computeSkillHealthFromSegments(segments: SkillSegment[], sessions: CcSession[], tracePath: string, opts?: AnalyzeOptions): SkillHealthReport;
+//# sourceMappingURL=production-analyzer.d.ts.map

package/dist/src/observability/production-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"production-analyzer.d.ts","sourceRoot":"","sources":["../../../src/observability/production-analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAwC,KAAK,cAAc,EAAE,MAAM,kCAAkC,CAAC;AAE7G,OAAO,KAAK,EAAE,SAAS,EAAe,MAAM,aAAa,CAAC;AAC1D,OAAO,EAGL,KAAK,SAAS,EACd,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,cAAc,GAAG,IAAI,CAAC;IAChC,GAAG,EAAE,SAAS,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE;QACJ,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QACxC,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACrC,OAAO,EAAE;QACP,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,OAAO,GAAG,QAAQ,GAAG,KAAK,CAAC;KACxC,CAAC;CACH;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AA2CD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,iBAAiB,CAqExG;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,YAAY,EAAE,EACxB,QAAQ,EAAE,SAAS,EAAE,EACrB,SAAS,EAAE,MAAM,EACjB,IAAI,GAAE,cAAmB,GACxB,iBAAiB,CAOnB"}

package/dist/src/observability/production-analyzer.js

@@ -0,0 +1,183 @@
+/**
+ * Production analyzer (v0.18 skill-health).
+ *
+ * 接 trace-adapter 输出 → 按 skill 维度聚合 coverage + gap,产出 SkillHealthReport。
+ * 复用 analysis/coverage-analyzer + analysis/gap-analyzer,跳过对照组逻辑。
+ *
+ * 分析流水线:
+ *   1. ccTracesToResultEntries(path) → segments + ResultEntry[]
+ *   2. 时间窗 / skill 白名单过滤
+ *   3. 按 skill name (variant key) 分别 computeCoverage + computeGapReport
+ *   4. 聚合 overall 指标 + 健康度色带
+ */
+import { buildKnowledgeIndex, computeCoverage } from '../analysis/coverage-analyzer.js';
+import { computeGapReport } from '../analysis/gap-analyzer.js';
+import { ccTracesToResultEntries, segmentsToResultEntries, } from './trace-adapter.js';
+/**
+ * 从时间戳字符串比较。ISO8601 字典序即时序,直接用字符串比较。
+ */
+function timestampLt(a, b) {
+    return a < b;
+}
+/**
+ * 判断 segment 是否落在时间窗内(闭区间)。
+ */
+function withinTimeWindow(seg, from, to) {
+    if (from && timestampLt(seg.startTimestamp, from))
+        return false;
+    if (to && timestampLt(to, seg.startTimestamp))
+        return false;
+    return true;
+}
+/**
+ * overall 健康度色带。阈值对齐 bench ci --max-gap-rate 经验值(spec §五)。
+ */
+function healthBandOf(weightedGapRate) {
+    if (weightedGapRate >= 0.3)
+        return 'red';
+    if (weightedGapRate >= 0.1)
+        return 'yellow';
+    return 'green';
+}
+/**
+ * 推断 KB root: 没传 --kb 时,取第一个 assistant record 的 cwd。
+ * 如果跨多个 cwd,取第一个并 warn。
+ */
+function inferKbRoot(sessions) {
+    const cwds = new Set();
+    for (const s of sessions) {
+        if (s.cwd)
+            cwds.add(s.cwd);
+    }
+    if (cwds.size === 0)
+        return null;
+    if (cwds.size > 1) {
+        process.stderr.write(`[omk] analyze: trace spans ${cwds.size} projects, coverage defaults to first cwd. Pass --kb explicitly for cross-project analysis.\n`);
+    }
+    return cwds.values().next().value ?? null;
+}
+/**
+ * 主入口:从 cc trace 目录生成 SkillHealthReport。
+ */
+export function computeSkillHealthReport(tracePath, opts = {}) {
+    const { sessions, segments } = ccTracesToResultEntries(tracePath);
+    // 时间窗 + skill 白名单过滤
+    let filtered = segments.filter((s) => withinTimeWindow(s, opts.from, opts.to));
+    if (opts.skills?.length) {
+        const allow = new Set(opts.skills);
+        filtered = filtered.filter((s) => allow.has(s.skillName));
+    }
+    const filteredEntries = segmentsToResultEntries(filtered);
+    // 推断 KB root
+    const kbRoot = opts.kbRoot ?? inferKbRoot(sessions);
+    const index = kbRoot ? buildKnowledgeIndex(kbRoot) : null;
+    // 按 skill 分组聚合
+    const skillNames = [...new Set(filtered.map((s) => s.skillName))];
+    const bySkill = {};
+    for (const skill of skillNames) {
+        const skillSegs = filtered.filter((s) => s.skillName === skill);
+        const coverage = index ? computeCoverage(filteredEntries, skill, index, kbRoot) : null;
+        const gap = computeGapReport(filteredEntries, skill);
+        // 挂 trace 源作水印(spec §六)
+        gap.testSetPath = tracePath;
+        bySkill[skill] = {
+            skillName: skill,
+            segmentCount: skillSegs.length,
+            toolCallCount: skillSegs.reduce((a, s) => a + s.metrics.numToolCalls, 0),
+            toolFailureCount: skillSegs.reduce((a, s) => a + s.metrics.numToolFailures, 0),
+            coverage,
+            gap,
+        };
+    }
+    // Overall 聚合(加权平均,权重 = 每个 skill 的 segment 数)
+    const totalSegments = filtered.length;
+    const totalGap = Object.values(bySkill).reduce((a, h) => a + h.gap.samplesWithGap, 0);
+    const totalWeighted = Object.values(bySkill).reduce((a, h) => a + h.gap.weightedGapRate * h.gap.sampleCount, 0);
+    const gapRate = totalSegments > 0 ? Number((totalGap / totalSegments).toFixed(4)) : 0;
+    const weightedGapRate = totalSegments > 0 ? Number((totalWeighted / totalSegments).toFixed(4)) : 0;
+    // meta
+    const totalToolCalls = filtered.reduce((a, s) => a + s.metrics.numToolCalls, 0);
+    const totalFailures = filtered.reduce((a, s) => a + s.metrics.numToolFailures, 0);
+    const timeRange = filtered.length > 0
+        ? {
+            from: filtered.reduce((m, s) => (timestampLt(s.startTimestamp, m) ? s.startTimestamp : m), filtered[0].startTimestamp),
+            to: filtered.reduce((m, s) => (timestampLt(m, s.endTimestamp) ? s.endTimestamp : m), filtered[0].endTimestamp),
+        }
+        : { from: '', to: '' };
+    return {
+        meta: {
+            tracePath,
+            kbPath: kbRoot,
+            sessionCount: sessions.length,
+            segmentCount: totalSegments,
+            messageCount: sessions.reduce((a, s) => a + s.records.length, 0),
+            toolCallCount: totalToolCalls,
+            toolFailureRate: totalToolCalls > 0 ? Number((totalFailures / totalToolCalls).toFixed(4)) : 0,
+            timeRange,
+            generatedAt: new Date().toISOString(),
+        },
+        bySkill,
+        overall: { gapRate, weightedGapRate, healthBand: healthBandOf(weightedGapRate) },
+    };
+}
+/**
+ * 便利入口:直接从已准备好的 segments(跳过 loadCcSessions)算 report。
+ * 用于测试 / 已手工组装过 segments 的场景。
+ */
+export function computeSkillHealthFromSegments(segments, sessions, tracePath, opts = {}) {
+    const filteredSegs = segments.filter((s) => withinTimeWindow(s, opts.from, opts.to));
+    const finalSegs = opts.skills?.length
+        ? filteredSegs.filter((s) => opts.skills.includes(s.skillName))
+        : filteredSegs;
+    const finalEntries = segmentsToResultEntries(finalSegs);
+    return buildReport(finalSegs, finalEntries, sessions, tracePath, opts);
+}
+function buildReport(segments, entries, sessions, tracePath, opts) {
+    const kbRoot = opts.kbRoot ?? inferKbRoot(sessions);
+    const index = kbRoot ? buildKnowledgeIndex(kbRoot) : null;
+    const skillNames = [...new Set(segments.map((s) => s.skillName))];
+    const bySkill = {};
+    for (const skill of skillNames) {
+        const skillSegs = segments.filter((s) => s.skillName === skill);
+        const coverage = index ? computeCoverage(entries, skill, index, kbRoot) : null;
+        const gap = computeGapReport(entries, skill);
+        gap.testSetPath = tracePath;
+        bySkill[skill] = {
+            skillName: skill,
+            segmentCount: skillSegs.length,
+            toolCallCount: skillSegs.reduce((a, s) => a + s.metrics.numToolCalls, 0),
+            toolFailureCount: skillSegs.reduce((a, s) => a + s.metrics.numToolFailures, 0),
+            coverage,
+            gap,
+        };
+    }
+    const totalSegments = segments.length;
+    const totalGap = Object.values(bySkill).reduce((a, h) => a + h.gap.samplesWithGap, 0);
+    const totalWeighted = Object.values(bySkill).reduce((a, h) => a + h.gap.weightedGapRate * h.gap.sampleCount, 0);
+    const gapRate = totalSegments > 0 ? Number((totalGap / totalSegments).toFixed(4)) : 0;
+    const weightedGapRate = totalSegments > 0 ? Number((totalWeighted / totalSegments).toFixed(4)) : 0;
+    const totalToolCalls = segments.reduce((a, s) => a + s.metrics.numToolCalls, 0);
+    const totalFailures = segments.reduce((a, s) => a + s.metrics.numToolFailures, 0);
+    const timeRange = segments.length > 0
+        ? {
+            from: segments.reduce((m, s) => (timestampLt(s.startTimestamp, m) ? s.startTimestamp : m), segments[0].startTimestamp),
+            to: segments.reduce((m, s) => (timestampLt(m, s.endTimestamp) ? s.endTimestamp : m), segments[0].endTimestamp),
+        }
+        : { from: '', to: '' };
+    return {
+        meta: {
+            tracePath,
+            kbPath: kbRoot,
+            sessionCount: sessions.length,
+            segmentCount: totalSegments,
+            messageCount: sessions.reduce((a, s) => a + s.records.length, 0),
+            toolCallCount: totalToolCalls,
+            toolFailureRate: totalToolCalls > 0 ? Number((totalFailures / totalToolCalls).toFixed(4)) : 0,
+            timeRange,
+            generatedAt: new Date().toISOString(),
+        },
+        bySkill,
+        overall: { gapRate, weightedGapRate, healthBand: healthBandOf(weightedGapRate) },
+    };
+}
+//# sourceMappingURL=production-analyzer.js.map

package/dist/src/observability/production-analyzer.js.map

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

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

@@ -0,0 +1,75 @@
+/**
+ * cc session JSONL → omk ResultEntry adapter (v0.18 skill-health)。
+ *
+ * 核心职责:
+ *   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 type { ResultEntry, ToolCallInfo, TurnInfo } from '../types.js';
+export interface CcSession {
+    sessionId: string;
+    sourcePath: string;
+    records: unknown[];
+    cwd?: string;
+    gitBranch?: string;
+    startTimestamp?: string;
+    endTimestamp?: string;
+}
+export interface SkillSegment {
+    skillName: string;
+    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;
+    };
+}
+/**
+ * 加载一个目录(或单个 JSONL 文件)下的所有 cc session。目录递归只一层(cc 的实际布局)。
+ */
+export declare function loadCcSessions(path: string): CcSession[];
+/**
+ * 扫描 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[];
+/**
+ * 一站式:目录 → ResultEntry[]。
+ */
+export declare function ccTracesToResultEntries(path: string): {
+    entries: ResultEntry[];
+    sessions: CcSession[];
+    segments: SkillSegment[];
+};
+//# sourceMappingURL=trace-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trace-adapter.d.ts","sourceRoot":"","sources":["../../../src/observability/trace-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAiB,MAAM,aAAa,CAAC;AA+DtF,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;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,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;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,CASxD;AA8FD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,GAAG,YAAY,EAAE,CA+GjE;AAkDD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,WAAW,EAAE,CAO/E;AAgCD;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,WAAW,EAAE,CAAC;IAAC,QAAQ,EAAE,SAAS,EAAE,CAAC;IAAC,QAAQ,EAAE,YAAY,EAAE,CAAA;CAAE,CAKjI"}