oh-my-knowledge 0.30.0 → 0.32.0

package/dist/server/report-server.js

@@ -0,0 +1,892 @@
+import { createServer } from 'node:http';
+import { existsSync, mkdirSync, readdirSync, readFileSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { renderReportDocumentDetail, renderTrendsPage, renderRunList } from '../renderer/html-renderer.js';
+import { renderSkillList } from '../renderer/skill-list-renderer.js';
+import { renderSkillDetail } from '../renderer/skill-detail-renderer.js';
+import { renderSkillHealthReport } from '../renderer/skill-health-renderer.js';
+import { renderObservationInboxPage } from '../renderer/observation-inbox-renderer.js';
+import { DEFAULT_LANG, t, layout } from '../renderer/layout.js';
+import { buildSkillIndex } from './skill-index.js';
+import { createFileJobStore, DEFAULT_JOBS_DIR } from './job-store.js';
+import { createFileStore, queryJob, queryJobList, queryRun, queryRunList, queryTrend } from './report-store.js';
+import { DEFAULT_OBSERVATIONS_DIR, findObservationInboxItem, formatObservationShow, queryObservationInbox } from '../observability/inbox.js';
+import { buildObservationInboxViewModel } from '../observability/inbox-view-model.js';
+import { activeStudioDiagnostics } from '../diagnosis/studio-projection.js';
+import { deleteObservationReviewState, loadObservationReviewState, updateObservationReviewState } from '../observability/review-state.js';
+import { updateSkillDerivedStandardStatus } from '../observability/soft-standards/index.js';
+const DEFAULT_PORT = 7799;
+const PORT_HINT = `OMK_REPORT_PORT=${DEFAULT_PORT} omk eval ...`;
+const DEFAULT_REPORTS_DIR = join(homedir(), '.oh-my-knowledge', 'reports');
+const DEFAULT_ANALYSES_DIR = join(homedir(), '.oh-my-knowledge', 'analyses');
+const DEFAULT_DOCTORS_DIR = join(homedir(), '.oh-my-knowledge', 'doctors');
+let cachedChartJsBytes;
+function loadChartJsBundle() {
+    if (cachedChartJsBytes !== undefined)
+        return cachedChartJsBytes;
+    try {
+        // chart.js 的 exports 字段不允许直接 resolve 子路径,先 resolve 主入口拿到包目录,
+        // 再拼到 dist/chart.umd.min.js(这个 UMD 在 sideEffects 里声明,实际存在)。
+        const req = createRequire(import.meta.url);
+        const mainPath = req.resolve('chart.js');
+        const distDir = mainPath.replace(/[/\\]chart\.cjs$/, '').replace(/[/\\]chart\.js$/, '');
+        const umdPath = join(distDir, 'chart.umd.min.js');
+        cachedChartJsBytes = readFileSync(umdPath, 'utf-8');
+    }
+    catch {
+        cachedChartJsBytes = null;
+    }
+    return cachedChartJsBytes;
+}
+function listAnalyses(dir) {
+    if (!existsSync(dir))
+        return [];
+    const items = [];
+    for (const file of readdirSync(dir)) {
+        if (!file.endsWith('.json'))
+            continue;
+        try {
+            const data = JSON.parse(readFileSync(join(dir, file), 'utf-8'));
+            if (!data.meta || !data.overall)
+                continue;
+            items.push({
+                id: file.replace(/\.json$/, ''),
+                generatedAt: data.meta.generatedAt,
+                sessionCount: data.meta.sessionCount,
+                segmentCount: data.meta.segmentCount,
+                skillCount: Object.keys(data.bySkill || {}).length,
+                healthBand: data.overall.healthBand,
+            });
+        }
+        catch { /* skip corrupt */ }
+    }
+    // 最新在前
+    items.sort((a, b) => b.generatedAt.localeCompare(a.generatedAt));
+    return items;
+}
+function loadAnalysis(dir, id) {
+    const path = join(dir, `${id}.json`);
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 扫 analyses/ 所有 JSON,按 skillName 过滤,按时间排序成 trend points。
+ */
+function querySkillTrend(dir, skillName) {
+    const items = listAnalyses(dir);
+    const points = [];
+    for (const it of items) {
+        const report = loadAnalysis(dir, it.id);
+        if (!report)
+            continue;
+        const h = report.bySkill[skillName];
+        if (!h)
+            continue;
+        // 旧格式 (加 usage 字段前的 analysis) 用 safe access,缺字段降级为 0/undefined
+        const u = h.usage;
+        const billable = (u?.inputTokens ?? 0) + (u?.outputTokens ?? 0);
+        const cached = (u?.cacheReadTokens ?? 0) + (u?.cacheCreationTokens ?? 0);
+        points.push({
+            analysisId: it.id,
+            generatedAt: report.meta.generatedAt,
+            gapRate: h.gap?.gapRate ?? 0,
+            weightedGapRate: h.gap?.weightedGapRate ?? 0,
+            failureRate: h.toolFailureRate ?? 0,
+            coverageRate: h.coverage?.fileCoverageRate ?? null,
+            billableTokens: billable,
+            cachedTokens: cached,
+            totalTokens: u?.totalTokens ?? 0,
+            avgTokensPerSegment: u?.avgTokensPerSegment ?? 0,
+            durationMs: u?.durationMs ?? 0,
+            segmentCount: h.segmentCount ?? 0,
+            stability: h.stability ?? 'stable',
+        });
+    }
+    // 最旧在前,便于折线图从左到右展示时间序列
+    points.sort((a, b) => a.generatedAt.localeCompare(b.generatedAt));
+    return { skillName, points };
+}
+/**
+ * 比较两份 skill health report. `from` 通常是较早的,`to` 是较晚的;
+ * 对于每个 skill, 显示前后值和 delta. 缺失一侧时 presence 标记。
+ */
+function querySkillDiff(dir, fromId, toId) {
+    const from = loadAnalysis(dir, fromId);
+    const to = loadAnalysis(dir, toId);
+    if (!from || !to)
+        return null;
+    const allSkills = new Set([...Object.keys(from.bySkill), ...Object.keys(to.bySkill)]);
+    const rows = [];
+    for (const skill of allSkills) {
+        const f = from.bySkill[skill];
+        const t = to.bySkill[skill];
+        if (f && t) {
+            rows.push({
+                skillName: skill,
+                presence: 'both',
+                fromGap: f.gap.weightedGapRate,
+                toGap: t.gap.weightedGapRate,
+                deltaGap: t.gap.weightedGapRate - f.gap.weightedGapRate,
+                fromFailure: f.toolFailureRate,
+                toFailure: t.toolFailureRate,
+                deltaFailure: t.toolFailureRate - f.toolFailureRate,
+                fromCoverage: f.coverage?.fileCoverageRate ?? null,
+                toCoverage: t.coverage?.fileCoverageRate ?? null,
+                deltaCoverage: (f.coverage?.fileCoverageRate != null && t.coverage?.fileCoverageRate != null)
+                    ? t.coverage.fileCoverageRate - f.coverage.fileCoverageRate
+                    : null,
+                fromSegments: f.segmentCount,
+                toSegments: t.segmentCount,
+                deltaSegments: t.segmentCount - f.segmentCount,
+            });
+        }
+        else if (f) {
+            rows.push({ skillName: skill, presence: 'only-from', fromGap: f.gap.weightedGapRate, fromFailure: f.toolFailureRate, fromCoverage: f.coverage?.fileCoverageRate ?? null, fromSegments: f.segmentCount });
+        }
+        else if (t) {
+            rows.push({ skillName: skill, presence: 'only-to', toGap: t.gap.weightedGapRate, toFailure: t.toolFailureRate, toCoverage: t.coverage?.fileCoverageRate ?? null, toSegments: t.segmentCount });
+        }
+    }
+    // 按 deltaGap 绝对值倒序 (变化大的在前,缺失的放最后)
+    rows.sort((a, b) => {
+        const aDelta = a.presence === 'both' ? Math.abs(a.deltaGap) : -1;
+        const bDelta = b.presence === 'both' ? Math.abs(b.deltaGap) : -1;
+        return bDelta - aDelta;
+    });
+    return { fromId, toId, fromAt: from.meta.generatedAt, toAt: to.meta.generatedAt, rows };
+}
+function fmtDelta(d, isPercent = true) {
+    if (d == null)
+        return '—';
+    const pct = isPercent ? d * 100 : d;
+    const sign = pct > 0 ? '+' : '';
+    const color = Math.abs(pct) < 1 ? '#888' : pct > 0 ? '#dc2626' : '#16a34a';
+    return `<span style="color:${color}">${sign}${pct.toFixed(isPercent ? 1 : 0)}${isPercent ? '%' : ''}</span>`;
+}
+function fmtPct(v) {
+    if (v == null)
+        return '—';
+    return `${Math.round(v * 100)}%`;
+}
+function readJsonBody(req, maxBytes = 1024 * 1024) {
+    return new Promise((resolve, reject) => {
+        let size = 0;
+        const chunks = [];
+        req.on('data', (chunk) => {
+            size += chunk.length;
+            if (size > maxBytes) {
+                reject(new Error('request body too large'));
+                req.destroy();
+                return;
+            }
+            chunks.push(chunk);
+        });
+        req.on('end', () => {
+            try {
+                const raw = Buffer.concat(chunks).toString('utf-8').trim();
+                resolve(raw ? JSON.parse(raw) : {});
+            }
+            catch {
+                reject(new Error('invalid json body'));
+            }
+        });
+        req.on('error', reject);
+    });
+}
+function renderSkillDiffPage(diff, lang = DEFAULT_LANG) {
+    const { fromId, toId, fromAt, toAt, rows } = diff;
+    const langQ = lang === DEFAULT_LANG ? '' : `?lang=${lang}`;
+    const rowHtml = rows.map((r) => {
+        const tag = r.presence === 'only-from' ? `<span style="color:var(--green);font-size:10px;padding:1px 6px;background:var(--green-bg);border-radius:3px" data-i18n="diffTagRemoved">${t('diffTagRemoved', lang)}</span>`
+            : r.presence === 'only-to' ? `<span style="color:var(--accent);font-size:10px;padding:1px 6px;background:var(--info-bg);border-radius:3px" data-i18n="diffTagNew">${t('diffTagNew', lang)}</span>`
+                : '';
+        return `<tr>
+      <td style="padding:8px 10px;font-family:ui-monospace,monospace">${r.skillName} ${tag}</td>
+      <td style="padding:8px 10px;text-align:right">${r.fromSegments ?? '—'} → ${r.toSegments ?? '—'} ${r.presence === 'both' ? `(${fmtDelta(r.deltaSegments, false)})` : ''}</td>
+      <td style="padding:8px 10px;text-align:right">${fmtPct(r.fromGap)} → ${fmtPct(r.toGap)} ${r.presence === 'both' ? fmtDelta(r.deltaGap) : ''}</td>
+      <td style="padding:8px 10px;text-align:right">${fmtPct(r.fromFailure)} → ${fmtPct(r.toFailure)} ${r.presence === 'both' ? fmtDelta(r.deltaFailure) : ''}</td>
+      <td style="padding:8px 10px;text-align:right">${fmtPct(r.fromCoverage)} → ${fmtPct(r.toCoverage)} ${r.presence === 'both' && r.deltaCoverage != null ? fmtDelta(r.deltaCoverage) : ''}</td>
+    </tr>`;
+    }).join('');
+    const body = `
+    <main style="max-width:1000px;margin:0 auto;padding:24px">
+      <nav style="margin-bottom:8px">
+        <a href="/analyses${langQ}" data-i18n="backToAnalyses" style="color:var(--accent);text-decoration:none;margin-right:12px">${t('backToAnalyses', lang)}</a>
+        <a href="/analyses/${encodeURIComponent(fromId)}${langQ}" data-i18n="diffNavFrom" style="color:var(--accent);text-decoration:none;margin-right:12px">${t('diffNavFrom', lang)}</a>
+        <a href="/analyses/${encodeURIComponent(toId)}${langQ}" data-i18n="diffNavTo" style="color:var(--accent);text-decoration:none">${t('diffNavTo', lang)}</a>
+      </nav>
+      <h1 data-i18n="skillDiffHeading" style="font-size:20px;margin:8px 0">${t('skillDiffHeading', lang)}</h1>
+      <div style="color:var(--text-muted);font-size:13px;margin-bottom:20px">
+        <span data-i18n="diffNavFrom">${t('diffNavFrom', lang)}</span> <code>${fromId}</code> (${fromAt.slice(0, 19).replace('T', ' ')}) → <span data-i18n="diffNavTo">${t('diffNavTo', lang)}</span> <code>${toId}</code> (${toAt.slice(0, 19).replace('T', ' ')})<br/>
+        <span data-i18n="diffSortHint">${t('diffSortHint', lang)}</span>
+      </div>
+      <table style="border-collapse:collapse;width:100%;font-size:13px">
+        <thead><tr>
+          <th style="text-align:left;padding:10px;border-bottom:2px solid var(--border);font-weight:600" data-i18n="diffColSkill">${t('diffColSkill', lang)}</th>
+          <th style="text-align:right;padding:10px;border-bottom:2px solid var(--border);font-weight:600" data-i18n="diffColSegments">${t('diffColSegments', lang)}</th>
+          <th style="text-align:right;padding:10px;border-bottom:2px solid var(--border);font-weight:600" data-i18n="diffColWeightedGap">${t('diffColWeightedGap', lang)}</th>
+          <th style="text-align:right;padding:10px;border-bottom:2px solid var(--border);font-weight:600" data-i18n="diffColFailureRate">${t('diffColFailureRate', lang)}</th>
+          <th style="text-align:right;padding:10px;border-bottom:2px solid var(--border);font-weight:600" data-i18n="diffColCoverage">${t('diffColCoverage', lang)}</th>
+        </tr></thead>
+        <tbody>${rowHtml}</tbody>
+      </table>
+    </main>`;
+    return layout(t('skillDiffHeading', lang), body, lang);
+}
+function renderSkillTrendPage(trend, lang = DEFAULT_LANG) {
+    const { skillName, points } = trend;
+    const langQ = lang === DEFAULT_LANG ? '' : `?lang=${lang}`;
+    if (points.length === 0) {
+        const emptyBody = `
+    <main style="max-width:900px;margin:0 auto;padding:24px">
+      <nav style="margin-bottom:12px"><a href="/analyses${langQ}" data-i18n="backToAnalyses" style="color:var(--accent);text-decoration:none">${t('backToAnalyses', lang)}</a></nav>
+      <h1 style="font-size:20px;margin:8px 0 4px"><span data-i18n="skillTrendHeading">${t('skillTrendHeading', lang)}</span> · ${skillName}</h1>
+      <p style="color:var(--text-muted)" data-i18n="noTrendData">${t('noTrendData', lang)}</p>
+    </main>`;
+        return layout(`${t('skillTrendHeading', lang)} · ${skillName}`, emptyBody, lang);
+    }
+    // SVG 折线图: gapRate 主线 + failureRate 辅线, X 轴时间序
+    const W = 760, H = 200, PAD = 40;
+    const toX = (i) => points.length === 1 ? W / 2 : PAD + (i / (points.length - 1)) * (W - 2 * PAD);
+    const toY = (v) => H - PAD - v * (H - 2 * PAD);
+    const pathOf = (key) => {
+        const usable = points.map((p, i) => ({ x: toX(i), y: p[key] ?? null }));
+        let d = '';
+        for (const pt of usable) {
+            if (pt.y == null)
+                continue;
+            d += d ? ` L ${pt.x} ${toY(pt.y)}` : `M ${pt.x} ${toY(pt.y)}`;
+        }
+        return d;
+    };
+    const dots = (key, color) => points.map((p, i) => p[key] == null ? '' : `<circle cx="${toX(i)}" cy="${toY(p[key])}" r="3" fill="${color}"/>`).join('');
+    const yTicks = [0, 0.5, 1.0].map((v) => `<g><line x1="${PAD}" y1="${toY(v)}" x2="${W - PAD}" y2="${toY(v)}" stroke="var(--border)"/><text x="${PAD - 6}" y="${toY(v) + 4}" text-anchor="end" font-size="11" fill="var(--text-muted)">${Math.round(v * 100)}%</text></g>`).join('');
+    const svg = `<svg viewBox="0 0 ${W} ${H}" style="width:100%;max-width:${W}px;height:${H}px;background:var(--bg-surface);border:1px solid var(--border);border-radius:var(--radius)">
+    ${yTicks}
+    <path d="${pathOf('gapRate')}" stroke="#f87171" stroke-width="2" fill="none"/>
+    <path d="${pathOf('weightedGapRate')}" stroke="#fbbf24" stroke-width="2" fill="none" stroke-dasharray="4 4"/>
+    <path d="${pathOf('failureRate')}" stroke="#a78bfa" stroke-width="2" fill="none"/>
+    <path d="${pathOf('coverageRate')}" stroke="#4ade80" stroke-width="2" fill="none"/>
+    ${dots('gapRate', '#f87171')}${dots('weightedGapRate', '#fbbf24')}${dots('failureRate', '#a78bfa')}${dots('coverageRate', '#4ade80')}
+  </svg>`;
+    const legend = `<div style="margin:12px 0;font-size:12px;color:var(--text-secondary)">
+    <span style="color:#f87171">● <span data-i18n="trendLegendGap">${t('trendLegendGap', lang)}</span></span> ·
+    <span style="color:#fbbf24">◆ <span data-i18n="trendLegendWeighted">${t('trendLegendWeighted', lang)}</span></span> ·
+    <span style="color:#a78bfa">● <span data-i18n="trendLegendFailure">${t('trendLegendFailure', lang)}</span></span> ·
+    <span style="color:#4ade80">● <span data-i18n="trendLegendCoverage">${t('trendLegendCoverage', lang)}</span></span>
+  </div>`;
+    const rows = points.map((p) => `<tr>
+    <td style="padding:6px 10px;font-family:ui-monospace,monospace;font-size:12px"><a href="/analyses/${encodeURIComponent(p.analysisId)}${langQ}" style="color:var(--accent);text-decoration:none">${p.generatedAt.slice(0, 19).replace('T', ' ')}</a></td>
+    <td style="padding:6px 10px;text-align:right">${p.segmentCount}</td>
+    <td style="padding:6px 10px;text-align:right;color:#f87171">${Math.round(p.gapRate * 100)}%</td>
+    <td style="padding:6px 10px;text-align:right;color:#fbbf24">${Math.round(p.weightedGapRate * 100)}%</td>
+    <td style="padding:6px 10px;text-align:right;color:#a78bfa">${Math.round(p.failureRate * 100)}%</td>
+    <td style="padding:6px 10px;text-align:right;color:#4ade80">${p.coverageRate == null ? '—' : Math.round(p.coverageRate * 100) + '%'}</td>
+    <td style="padding:6px 10px;text-align:right;font-family:ui-monospace,monospace;font-size:12px" title="input+output only; cache 分开计">${(p.billableTokens / 1000).toFixed(1)}k</td>
+    <td style="padding:6px 10px;text-align:right;font-family:ui-monospace,monospace;font-size:12px">${(p.durationMs / 1000).toFixed(1)}s</td>
+  </tr>`).join('');
+    const subtitle = `${points.length} <span data-i18n="trendNPoints">${t('trendNPoints', lang)}</span> · <span data-i18n="trendEarliest">${t('trendEarliest', lang)}</span> ${points[0].generatedAt.slice(0, 10)} · <span data-i18n="trendLatest">${t('trendLatest', lang)}</span> ${points[points.length - 1].generatedAt.slice(0, 10)}`;
+    const body = `
+    <main style="max-width:900px;margin:0 auto;padding:24px">
+      <nav style="margin-bottom:8px"><a href="/analyses${langQ}" data-i18n="backToAnalyses" style="color:var(--accent);text-decoration:none">${t('backToAnalyses', lang)}</a></nav>
+      <h1 style="font-size:20px;margin:8px 0 4px"><span data-i18n="skillTrendHeading">${t('skillTrendHeading', lang)}</span> · ${skillName}</h1>
+      <div style="color:var(--text-muted);font-size:13px;margin-bottom:16px">${subtitle}</div>
+      ${svg}
+      ${legend}
+      <table style="border-collapse:collapse;width:100%;font-size:13px;margin-top:12px">
+        <thead><tr>
+          <th style="text-align:left;padding:8px 10px;border-bottom:2px solid var(--border);color:var(--text-secondary);font-weight:600" data-i18n="trendColTimestamp">${t('trendColTimestamp', lang)}</th>
+          <th style="text-align:right;padding:8px 10px;border-bottom:2px solid var(--border);color:var(--text-secondary);font-weight:600" data-i18n="trendColSegs">${t('trendColSegs', lang)}</th>
+          <th style="text-align:right;padding:8px 10px;border-bottom:2px solid var(--border);color:var(--text-secondary);font-weight:600" data-i18n="trendColGap">${t('trendColGap', lang)}</th>
+          <th style="text-align:right;padding:8px 10px;border-bottom:2px solid var(--border);color:var(--text-secondary);font-weight:600" data-i18n="trendColWeighted">${t('trendColWeighted', lang)}</th>
+          <th style="text-align:right;padding:8px 10px;border-bottom:2px solid var(--border);color:var(--text-secondary);font-weight:600" data-i18n="trendColFailure">${t('trendColFailure', lang)}</th>
+          <th style="text-align:right;padding:8px 10px;border-bottom:2px solid var(--border);color:var(--text-secondary);font-weight:600" data-i18n="trendColCoverage">${t('trendColCoverage', lang)}</th>
+          <th style="text-align:right;padding:8px 10px;border-bottom:2px solid var(--border);color:var(--text-secondary);font-weight:600" data-i18n="trendColTokens">${t('trendColTokens', lang)}</th>
+          <th style="text-align:right;padding:8px 10px;border-bottom:2px solid var(--border);color:var(--text-secondary);font-weight:600" data-i18n="trendColDuration">${t('trendColDuration', lang)}</th>
+        </tr></thead>
+        <tbody>${rows}</tbody>
+      </table>
+    </main>`;
+    return layout(`${t('skillTrendHeading', lang)} · ${skillName}`, body, lang);
+}
+function renderAnalysisList(items, lang = DEFAULT_LANG) {
+    const langQ = lang === DEFAULT_LANG ? '' : `?lang=${lang}`;
+    const body = items.length === 0
+        ? `
+    <main style="max-width:900px;margin:0 auto;padding:24px">
+      <nav style="margin-bottom:12px"><a href="/${langQ}" data-i18n="backToEvalReports" style="color:var(--accent);text-decoration:none">${t('backToEvalReports', lang)}</a></nav>
+      <h1 data-i18n="skillHealthTitle" style="font-size:20px;margin:8px 0 16px">${t('skillHealthTitle', lang)}</h1>
+      <div style="color:var(--text-muted);padding:16px" data-i18n="noAnalyses">${t('noAnalyses', lang)}</div>
+    </main>`
+        : (() => {
+            const rows = items.map((it) => {
+                const badgeColor = it.healthBand === 'red' ? 'var(--red)' : it.healthBand === 'yellow' ? 'var(--yellow)' : 'var(--green)';
+                const enc = encodeURIComponent(it.id);
+                return `<li style="padding:10px 14px;border-bottom:1px solid var(--border);list-style:none;display:flex;align-items:center;gap:12px">
+          <span style="display:inline-block;width:8px;height:8px;border-radius:50%;background:${badgeColor}"></span>
+          <label style="font-size:11px;color:var(--text-muted);display:flex;align-items:center;gap:3px"><input type="radio" name="from" value="${enc}" onchange="updateCompare()"> <span data-i18n="analysesFromLabel">${t('analysesFromLabel', lang)}</span></label>
+          <label style="font-size:11px;color:var(--text-muted);display:flex;align-items:center;gap:3px"><input type="radio" name="to" value="${enc}" onchange="updateCompare()"> <span data-i18n="analysesToLabel">${t('analysesToLabel', lang)}</span></label>
+          <a href="/analyses/${enc}${langQ}" style="color:var(--accent);text-decoration:none;flex:1;font-family:ui-monospace,monospace">${it.id}</a>
+          <span style="color:var(--text-muted);font-size:12px">${it.sessionCount} <span data-i18n="analysesSessions">${t('analysesSessions', lang)}</span> · ${it.segmentCount} <span data-i18n="analysesSegs">${t('analysesSegs', lang)}</span> · ${it.skillCount} <span data-i18n="analysesSkills">${t('analysesSkills', lang)}</span></span>
+        </li>`;
+            }).join('');
+            return `
+      <main style="max-width:900px;margin:0 auto;padding:24px">
+        <nav style="margin-bottom:12px"><a href="/${langQ}" data-i18n="backToEvalReports" style="color:var(--accent);text-decoration:none">${t('backToEvalReports', lang)}</a></nav>
+        <h1 data-i18n="skillHealthTitle" style="font-size:20px;margin:8px 0 16px">${t('skillHealthTitle', lang)}</h1>
+        <div style="margin-bottom:12px;padding:8px 12px;background:var(--bg-surface);border-radius:var(--radius);font-size:12px;color:var(--text-secondary)">
+          <span data-i18n="analysesCompareHint">${t('analysesCompareHint', lang)}</span>
+          <a id="compare-btn" style="margin-left:8px;padding:4px 10px;background:var(--accent);color:white;text-decoration:none;border-radius:3px;opacity:0.4;pointer-events:none" data-i18n="analysesCompareBtn">${t('analysesCompareBtn', lang)}</a>
+        </div>
+        <ul style="padding:0;margin:0;border:1px solid var(--border);border-radius:var(--radius);overflow:hidden">${rows}</ul>
+      </main>
+      <script>
+        function updateCompare() {
+          var f = document.querySelector('input[name=from]:checked');
+          var t2 = document.querySelector('input[name=to]:checked');
+          var btn = document.getElementById('compare-btn');
+          if (f && t2 && f.value !== t2.value) {
+            btn.href = '/analyses-diff?from=' + f.value + '&to=' + t2.value + '&lang=' + (document.documentElement.dataset.lang || '${DEFAULT_LANG}');
+            btn.style.opacity = '1';
+            btn.style.pointerEvents = 'auto';
+          } else {
+            btn.removeAttribute('href');
+            btn.style.opacity = '0.4';
+            btn.style.pointerEvents = 'none';
+          }
+        }
+      </script>`;
+        })();
+    return layout(t('skillHealthTitle', lang), body, lang);
+}
+function getErrorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+// Returns Error to throw, or null when caller should fall through to the
+// EADDRINUSE / omk-takeover flow. Splits "occupancy" from "permission" /
+// "ephemeral-bind-rejected" so users see a fix path that matches the cause.
+export function formatListenError(p, err) {
+    const errno = err?.code;
+    // p === 0 asks the OS to pick an ephemeral port; "already in use" is
+    // semantically wrong here. Failures are almost always sandbox / restricted
+    // network environments rather than occupancy.
+    if (p === 0) {
+        return new Error(`cannot bind ephemeral port (--port 0): ${errno ?? 'unknown error'}.\n` +
+            `  likely cause: sandboxed / restricted network environment ` +
+            `(Docker without --net=host, container without bind permission).\n` +
+            `  try a fixed port: ${PORT_HINT}`);
+    }
+    // EACCES / EPERM: permission, not occupancy. Common on privileged ports
+    // (<1024 without root) or sandbox / container restrictions.
+    if (errno === 'EACCES' || errno === 'EPERM') {
+        return new Error(`cannot bind port ${p}: permission denied (${errno}).\n` +
+            `  ports < 1024 require root on Unix; sandboxed environments may block all binds.\n` +
+            `  pick another unblocked port: ${PORT_HINT}`);
+    }
+    // Any other syscall errno that isn't EADDRINUSE: surface it directly,
+    // don't try the omk-takeover flow.
+    if (errno && errno !== 'EADDRINUSE') {
+        return new Error(`cannot bind port ${p}: ${errno} (${getErrorMessage(err)}).\n` +
+            `  pick another port: ${PORT_HINT}`);
+    }
+    // EADDRINUSE or unknown — let caller try the omk-takeover flow.
+    return null;
+}
+export function createReportServer({ port, host: hostOption, reportsDir = DEFAULT_REPORTS_DIR, analysesDir = DEFAULT_ANALYSES_DIR, doctorsDir = DEFAULT_DOCTORS_DIR, observationsDir = DEFAULT_OBSERVATIONS_DIR, jobsDir = DEFAULT_JOBS_DIR, store, jobStore } = {}) {
+    let server = null;
+    let serverUrl = null;
+    // Use provided store or default to file store
+    const reportStore = store || createFileStore(reportsDir);
+    const resolvedJobStore = jobStore || createFileJobStore(jobsDir);
+    async function handleRequest(req, res) {
+        try {
+            const parsed = new URL(req.url || '/', 'http://127.0.0.1');
+            const path = parsed.pathname;
+            const langParam = parsed.searchParams.get('lang');
+            const lang = langParam === 'en' ? 'en' : langParam === 'zh' ? 'zh' : DEFAULT_LANG;
+            if (path === '/health') {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: true, service: 'omk' }));
+                return;
+            }
+            // 静态资源:chart.js UMD bundle(供详情页趋势大图使用)。
+            // 用 require.resolve 拿包路径,避开 dist 相对路径脆弱性。
+            if (path === '/static/chart.js') {
+                const bytes = loadChartJsBundle();
+                if (!bytes) {
+                    res.writeHead(500, { 'Content-Type': 'text/plain; charset=utf-8' });
+                    res.end('chart.js asset unavailable');
+                    return;
+                }
+                res.writeHead(200, { 'Content-Type': 'application/javascript; charset=utf-8', 'Cache-Control': 'public, max-age=86400' });
+                res.end(bytes);
+                return;
+            }
+            if (path === '/api/shutdown' && req.method === 'POST') {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ ok: true }));
+                // Graceful shutdown after response sent
+                setTimeout(() => { if (server)
+                    server.close(); }, 100);
+                return;
+            }
+            if (path === '/api/reports') {
+                const runs = await queryRunList(reportStore);
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify(runs));
+                return;
+            }
+            if (path === '/api/analyses') {
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify(listAnalyses(analysesDir)));
+                return;
+            }
+            if (path === '/analyses') {
+                res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                res.end(renderAnalysisList(listAnalyses(analysesDir), lang));
+                return;
+            }
+            if (path === '/observations' || path === '/observations/inbox') {
+                const skill = parsed.searchParams.get('skill') || undefined;
+                const html = renderObservationInboxPage(buildObservationInboxViewModel(observationsDir, { skill }), lang);
+                res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                res.end(html);
+                return;
+            }
+            if (path === '/api/observations/inbox') {
+                const severity = parsed.searchParams.get('severity');
+                const skill = parsed.searchParams.get('skill');
+                const limitRaw = parsed.searchParams.get('limit');
+                const limit = limitRaw ? Math.max(1, Number(limitRaw) || 0) : 0;
+                let items = queryObservationInbox(observationsDir);
+                if (skill) {
+                    items = items.filter((item) => item.skillName === skill);
+                }
+                if (severity === 'high' || severity === 'medium' || severity === 'low' || severity === 'noise') {
+                    items = items.filter((item) => item.severity === severity);
+                }
+                if (limit > 0)
+                    items = items.slice(0, limit);
+                res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
+                res.end(JSON.stringify(items));
+                return;
+            }
+            if (path === '/api/observations/diagnostics') {
+                const runs = await reportStore.list();
+                const idx = buildSkillIndex(runs, analysesDir, doctorsDir, observationsDir);
+                res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
+                res.end(JSON.stringify({
+                    sourceCoverage: idx.diagnosisSummary.sourceCoverage,
+                    summary: idx.diagnosisSummary,
+                    bySkill: Object.fromEntries(idx.diagnosticsBySkill),
+                    active: activeStudioDiagnostics({
+                        schemaVersion: 1,
+                        generatedAt: new Date().toISOString(),
+                        sourceCoverage: idx.diagnosisSummary.sourceCoverage,
+                        bySkill: Object.fromEntries(idx.diagnosticsBySkill),
+                    }),
+                }));
+                return;
+            }
+            if (path === '/api/observations/show') {
+                const id = parsed.searchParams.get('id') || '';
+                const item = id ? findObservationInboxItem(id, observationsDir) : null;
+                res.writeHead(item ? 200 : 404, { 'Content-Type': 'application/json; charset=utf-8' });
+                res.end(JSON.stringify(item ? { id, text: formatObservationShow(item) } : { error: 'observation not found' }));
+                return;
+            }
+            if (path === '/api/observations/review-state') {
+                if (req.method === 'GET') {
+                    res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
+                    res.end(JSON.stringify(loadObservationReviewState(observationsDir)));
+                    return;
+                }
+                if (req.method === 'POST') {
+                    const body = await readJsonBody(req);
+                    const targetType = body.targetType;
+                    const targetId = String(body.targetId ?? '');
+                    const verdict = body.verdict;
+                    const now = new Date().toISOString();
+                    if (targetType === 'soft_standard') {
+                        const parsedTarget = parseSoftStandardReviewTarget(targetId);
+                        const status = skillDerivedStandardStatusFromVerdict(verdict);
+                        if (parsedTarget && status) {
+                            updateSkillDerivedStandardStatus(observationsDir, parsedTarget.skillName, parsedTarget.standardId, status, now);
+                        }
+                    }
+                    const state = updateObservationReviewState(observationsDir, {
+                        targetType,
+                        targetId,
+                        verdict,
+                        note: typeof body.note === 'string' ? body.note : undefined,
+                        reason: typeof body.reason === 'string' ? body.reason : undefined,
+                        metricKey: body.metricKey,
+                        metricScope: body.metricScope,
+                        metricScopeId: typeof body.metricScopeId === 'string' ? body.metricScopeId : undefined,
+                        sourceTrace: typeof body.sourceTrace === 'string' ? body.sourceTrace : undefined,
+                        sessionId: typeof body.sessionId === 'string' ? body.sessionId : undefined,
+                        messageIndex: typeof body.messageIndex === 'number' ? body.messageIndex : undefined,
+                        messageUuid: typeof body.messageUuid === 'string' ? body.messageUuid : undefined,
+                        toolUseId: typeof body.toolUseId === 'string' ? body.toolUseId : undefined,
+                        snippet: typeof body.snippet === 'string' ? body.snippet : undefined,
+                    }, now);
+                    res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
+                    res.end(JSON.stringify(state));
+                    return;
+                }
+                if (req.method === 'DELETE') {
+                    const targetType = parsed.searchParams.get('targetType');
+                    const targetId = parsed.searchParams.get('targetId') ?? '';
+                    const state = deleteObservationReviewState(observationsDir, targetType, targetId);
+                    res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
+                    res.end(JSON.stringify(state));
+                    return;
+                }
+                res.writeHead(405, { 'Content-Type': 'application/json; charset=utf-8' });
+                res.end(JSON.stringify({ error: 'method not allowed' }));
+                return;
+            }
+            const analysisDetailMatch = path.match(/^\/analyses\/(.+)$/);
+            if (analysisDetailMatch) {
+                const id = decodeURIComponent(analysisDetailMatch[1]);
+                const report = loadAnalysis(analysesDir, id);
+                if (!report) {
+                    res.writeHead(404, { 'Content-Type': 'text/plain' });
+                    res.end('analysis not found');
+                    return;
+                }
+                res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                res.end(renderSkillHealthReport(report, lang));
+                return;
+            }
+            const analysisApiMatch = path.match(/^\/api\/analyses\/(.+)$/);
+            if (analysisApiMatch) {
+                const id = decodeURIComponent(analysisApiMatch[1]);
+                const report = loadAnalysis(analysesDir, id);
+                if (!report) {
+                    res.writeHead(404, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'analysis not found' }));
+                    return;
+                }
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify(report));
+                return;
+            }
+            const skillTrendApiMatch = path.match(/^\/api\/skill-trend\/(.+)$/);
+            if (skillTrendApiMatch) {
+                const skillName = decodeURIComponent(skillTrendApiMatch[1]);
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify(querySkillTrend(analysesDir, skillName)));
+                return;
+            }
+            const skillTrendPageMatch = path.match(/^\/skill-trend\/(.+)$/);
+            if (skillTrendPageMatch) {
+                const skillName = decodeURIComponent(skillTrendPageMatch[1]);
+                res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                res.end(renderSkillTrendPage(querySkillTrend(analysesDir, skillName), lang));
+                return;
+            }
+            if (path === '/analyses-diff') {
+                const fromId = parsed.searchParams.get('from');
+                const toId = parsed.searchParams.get('to');
+                if (!fromId || !toId) {
+                    res.writeHead(400, { 'Content-Type': 'text/plain' });
+                    res.end('missing from/to query params');
+                    return;
+                }
+                const diff = querySkillDiff(analysesDir, fromId, toId);
+                if (!diff) {
+                    res.writeHead(404, { 'Content-Type': 'text/plain' });
+                    res.end('analysis not found');
+                    return;
+                }
+                res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                res.end(renderSkillDiffPage(diff, lang));
+                return;
+            }
+            if (path === '/api/analyses-diff') {
+                const fromId = parsed.searchParams.get('from');
+                const toId = parsed.searchParams.get('to');
+                if (!fromId || !toId) {
+                    res.writeHead(400, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'missing from/to query params' }));
+                    return;
+                }
+                const diff = querySkillDiff(analysesDir, fromId, toId);
+                if (!diff) {
+                    res.writeHead(404, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'analysis not found' }));
+                    return;
+                }
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify(diff));
+                return;
+            }
+            if (path === '/api/jobs') {
+                const limitParam = parsed.searchParams.get('limit');
+                const jobs = await queryJobList(resolvedJobStore, {
+                    status: parsed.searchParams.get('status') || undefined,
+                    reportId: parsed.searchParams.get('reportId') || undefined,
+                    project: parsed.searchParams.get('project') || undefined,
+                    owner: parsed.searchParams.get('owner') || undefined,
+                    tag: parsed.searchParams.get('tag') || undefined,
+                    limit: limitParam ? Number(limitParam) : undefined,
+                });
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify(jobs));
+                return;
+            }
+            const jobApiMatch = path.match(/^\/api\/job\/(.+)$/);
+            if (jobApiMatch) {
+                const job = await queryJob(resolvedJobStore, decodeURIComponent(jobApiMatch[1]));
+                if (!job) {
+                    res.writeHead(404, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'job not found' }));
+                    return;
+                }
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify(job));
+                return;
+            }
+            const reportApiMatch = path.match(/^\/api\/reports\/(.+)$/);
+            if (reportApiMatch) {
+                const id = decodeURIComponent(reportApiMatch[1]);
+                if (req.method === 'DELETE') {
+                    const removed = await reportStore.remove(id);
+                    if (!removed) {
+                        res.writeHead(404, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify({ error: 'report not found' }));
+                    }
+                    else {
+                        res.writeHead(200, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify({ ok: true }));
+                    }
+                    return;
+                }
+                const report = await queryRun(reportStore, id);
+                if (!report) {
+                    res.writeHead(404, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'report not found' }));
+                    return;
+                }
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify(report));
+                return;
+            }
+            // Trends API
+            const trendsApiMatch = path.match(/^\/api\/trends\/(.+)$/);
+            if (trendsApiMatch) {
+                const variantName = decodeURIComponent(trendsApiMatch[1]);
+                const trend = await queryTrend(reportStore, variantName);
+                res.writeHead(200, { 'Content-Type': 'application/json' });
+                res.end(JSON.stringify({ variant: trend.variant, points: trend.points }));
+                return;
+            }
+            // Trends page
+            const trendsPageMatch = path.match(/^\/trends\/(.+)$/);
+            if (trendsPageMatch) {
+                const variantName = decodeURIComponent(trendsPageMatch[1]);
+                const trend = await queryTrend(reportStore, variantName);
+                res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                res.end(renderTrendsPage(variantName, trend.runs, lang));
+                return;
+            }
+            const reportPageMatch = path.match(/^\/reports\/(.+)$/);
+            if (reportPageMatch) {
+                const report = await queryRun(reportStore, decodeURIComponent(reportPageMatch[1]));
+                res.writeHead(report ? 200 : 404, { 'Content-Type': 'text/html; charset=utf-8' });
+                res.end(renderReportDocumentDetail(report, lang));
+                return;
+            }
+            // 老 run 列表 — 兼容老书签。/skills/ 切换为默认后,run 列表挪这里。
+            if (path === '/runs') {
+                const runs = await reportStore.list();
+                res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                res.end(renderRunList(runs, lang));
+                return;
+            }
+            // 根路径走 skill-centric 列表页 — studio 顶级实体是 skill。
+            // insightsBySkill 在 buildSkillIndex 里跟 SkillIndex 一起算好并享受同一份缓存,
+            // list renderer 直接消费,不再每请求 N×detectInsights 重算。
+            if (path === '/') {
+                const runs = await reportStore.list();
+                const idx = buildSkillIndex(runs, analysesDir, doctorsDir, observationsDir);
+                res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                res.end(renderSkillList(idx, lang));
+                return;
+            }
+            if (path === '/api/skills') {
+                const runs = await reportStore.list();
+                const idx = buildSkillIndex(runs, analysesDir, doctorsDir, observationsDir);
+                res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
+                res.end(JSON.stringify({
+                    entries: idx.entries.map((entry) => ({
+                        ...entry,
+                        insightCount: idx.insightsBySkill.get(entry.skillName)?.length ?? 0,
+                        diagnosisCount: idx.diagnosticsBySkill.get(entry.skillName)?.length ?? 0,
+                    })),
+                    summary: idx.summary,
+                    diagnosisSummary: idx.diagnosisSummary,
+                }));
+                return;
+            }
+            // /skills/<name> 详情页 — 4 张卡片(doctor / eval-评分 / eval-功能 / observe)
+            // + 跨报告 cross-link + 行动建议。
+            const skillDetailMatch = path.match(/^\/skills\/(.+)$/);
+            if (skillDetailMatch) {
+                const skillName = decodeURIComponent(skillDetailMatch[1]);
+                const runs = await reportStore.list();
+                const idx = buildSkillIndex(runs, analysesDir, doctorsDir, observationsDir);
+                const entry = idx.entries.find((e) => e.skillName === skillName);
+                if (!entry) {
+                    res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' });
+                    res.end(`Skill not found: ${skillName}`);
+                    return;
+                }
+                // 加载完整 eval 报告(为详情页提供 layered scores / coverage / per-sample diagnostic)
+                let evalReport = null;
+                if (entry.eval) {
+                    const r = await reportStore.get(entry.eval.reportId);
+                    if (r && r.kind === 'evaluation')
+                        evalReport = r;
+                }
+                res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                const insights = idx.insightsBySkill.get(skillName) ?? [];
+                res.end(renderSkillDetail(entry, evalReport, lang, insights));
+                return;
+            }
+            const skillDiagnosticsApiMatch = path.match(/^\/api\/skills\/(.+)\/diagnostics$/);
+            if (skillDiagnosticsApiMatch) {
+                const skillName = decodeURIComponent(skillDiagnosticsApiMatch[1]);
+                const runs = await reportStore.list();
+                const idx = buildSkillIndex(runs, analysesDir, doctorsDir, observationsDir);
+                const diagnostics = idx.diagnosticsBySkill.get(skillName);
+                if (!diagnostics) {
+                    res.writeHead(404, { 'Content-Type': 'application/json; charset=utf-8' });
+                    res.end(JSON.stringify({ error: 'skill diagnostics not found' }));
+                    return;
+                }
+                res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
+                res.end(JSON.stringify({
+                    skillName,
+                    sourceCoverage: idx.diagnosisSummary.sourceCoverage,
+                    diagnostics,
+                }));
+                return;
+            }
+            res.writeHead(404, { 'Content-Type': 'text/plain' });
+            res.end('Not Found');
+        }
+        catch (err) {
+            if (res.headersSent) {
+                res.destroy(err instanceof Error ? err : new Error(getErrorMessage(err)));
+                return;
+            }
+            res.writeHead(500, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ error: getErrorMessage(err) }));
+        }
+    }
+    async function start() {
+        if (server)
+            return serverUrl;
+        if (!existsSync(reportsDir))
+            mkdirSync(reportsDir, { recursive: true });
+        if (!existsSync(analysesDir))
+            mkdirSync(analysesDir, { recursive: true });
+        if (!existsSync(observationsDir))
+            mkdirSync(observationsDir, { recursive: true });
+        if (!existsSync(jobsDir))
+            mkdirSync(jobsDir, { recursive: true });
+        const p = port ?? Number(process.env.OMK_REPORT_PORT || DEFAULT_PORT);
+        // host 默认 127.0.0.1(本机回环,默认安全)。容器/远程场景需对外暴露时:
+        //   - createReportServer({host: '0.0.0.0'}) — programmatic
+        //   - OMK_REPORT_HOST=0.0.0.0  omk studio  — 环境变量
+        //   - omk studio --host 0.0.0.0           — CLI flag
+        const host = hostOption || process.env.OMK_REPORT_HOST || '127.0.0.1';
+        const boot = (listenPort) => new Promise((resolve, reject) => {
+            const srv = createServer(handleRequest);
+            srv.once('error', reject);
+            srv.listen(listenPort, host, () => resolve(srv));
+        });
+        try {
+            server = await boot(p);
+        }
+        catch (err) {
+            const formatted = formatListenError(p, err);
+            if (formatted)
+                throw formatted;
+            // EADDRINUSE — check if it's an existing omk service we can take over
+            const probeHost = host === '0.0.0.0' ? '127.0.0.1' : host;
+            const url = `http://${probeHost}:${p}`;
+            let isOmk = false;
+            try {
+                const res = await fetch(`${url}/health`, { signal: AbortSignal.timeout(2000) });
+                const data = await res.json();
+                isOmk = data.service === 'omk';
+            }
+            catch { /* not reachable or not omk */ }
+            if (isOmk) {
+                // Shut down old omk service, then take over the port
+                try {
+                    await fetch(`${url}/api/shutdown`, { method: 'POST', signal: AbortSignal.timeout(2000) });
+                }
+                catch { /* ignore */ }
+                await new Promise((r) => setTimeout(r, 500));
+                try {
+                    server = await boot(p);
+                }
+                catch {
+                    throw new Error(`port ${p} is still in use; close it manually and retry: lsof -ti:${p} | xargs kill`);
+                }
+            }
+            else {
+                throw new Error(`port ${p} is already in use by another process.\n` +
+                    `  inspect: lsof -i:${p}\n` +
+                    `  release: lsof -ti:${p} | xargs kill\n` +
+                    `  or pick another port: ${PORT_HINT}`);
+            }
+        }
+        const addr = server.address();
+        const displayHost = host === '0.0.0.0' ? '127.0.0.1' : host;
+        serverUrl = `http://${displayHost}:${addr.port}`;
+        return serverUrl;
+    }
+    async function stop() {
+        if (!server)
+            return;
+        await new Promise((resolve) => server.close(() => resolve()));
+        server = null;
+        serverUrl = null;
+    }
+    function getUrl() {
+        return serverUrl;
+    }
+    return { start, stop, getUrl };
+}
+function parseSoftStandardReviewTarget(targetId) {
+    const separator = targetId.indexOf(':');
+    if (separator <= 0 || separator === targetId.length - 1)
+        return null;
+    return {
+        skillName: targetId.slice(0, separator),
+        standardId: targetId.slice(separator + 1),
+    };
+}
+function skillDerivedStandardStatusFromVerdict(verdict) {
+    if (verdict === 'real_issue')
+        return 'author_confirmed';
+    if (verdict === 'not_issue')
+        return 'rejected';
+    if (verdict === 'needs_more_context' || verdict === 'reviewed')
+        return 'pending_review';
+    return null;
+}
+//# sourceMappingURL=report-server.js.map