oh-my-knowledge 0.37.0 → 0.38.0

package/dist/server/report-server.d.ts

@@ -5,12 +5,26 @@ interface ReportServerOptions {
      *  暴露到容器外 / 局域网用 '0.0.0.0'。也可走 OMK_REPORT_HOST 环境变量。 */
     host?: string;
     reportsDir?: string;
-    analysesDir?: string;
-    doctorsDir?: string;
+    /** observe-health 报告目录(项目 .omk/observe-health 或全局),或一个按请求动态解析它的函数。
+     *  传函数 → 每次请求重解析(长会话里项目首次 omk observe 后从 global 实时切回 project);
+     *  传字符串 → 固定到该目录(测试 / 显式覆盖);默认动态解析 project→global 权威目录。 */
+    analysesDir?: string | (() => string);
+    /** 体检报告目录(项目 .omk/doctors 或全局),或一个按请求动态解析它的函数。三模式同 analysesDir。 */
+    doctorsDir?: string | (() => string);
     observationsDir?: string;
     jobsDir?: string;
+    /** 受管目录(.omk/managed 或全局),或一个按请求动态解析它的函数。只读消费,供 /managed 决策史页。
+     *  传函数 → 每次请求重解析(长会话里跟 omk list 同口径:项目首次 install 后从 global 实时切回 project);
+     *  传字符串 → 固定到该目录(测试 / 显式覆盖);默认动态解析 project→global 权威目录。 */
+    managedDir?: string | (() => string);
     store?: ReportStore;
     jobStore?: JobStore;
+    /** 是否把别项目的 observe-health 索引卡片合进列表 / 详情 / skill 首页(机器级总览)。
+     *  默认 false(固定目录 / 测试 hermetic);studio 仅在「无 --analyses-dir 且无 --global」的默认机器级模式传 true。 */
+    includeObserveCards?: boolean;
+    /** 是否把别项目的 doctor 索引卡片合进 skill 首页 / 详情兜底(机器级总览)。
+     *  默认 false;studio 仅在「无 --doctors-dir 且无 --global」的默认机器级模式传 true。 */
+    includeDoctorCards?: boolean;
 }
 interface ReportServer {
     start(): Promise<string>;
@@ -18,5 +32,5 @@ interface ReportServer {
     getUrl(): string | null;
 }
 export declare function formatListenError(p: number, err: unknown): Error | null;
-export declare function createReportServer({ port, host: hostOption, reportsDir, analysesDir, doctorsDir, observationsDir, jobsDir, store, jobStore }?: ReportServerOptions): ReportServer;
+export declare function createReportServer({ port, host: hostOption, reportsDir, analysesDir, doctorsDir, observationsDir, jobsDir, managedDir, store, jobStore, includeObserveCards, includeDoctorCards }?: ReportServerOptions): ReportServer;
 export {};

package/dist/server/report-server.js

@@ -2,7 +2,6 @@ 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 { renderSkillHealthReport } from '../renderer/skill-health-renderer.js';
@@ -10,9 +9,15 @@ import { renderDoctorDetail } from '../renderer/doctor-detail-renderer.js';
 import { assessHealth } from '../renderer/skill-detail-renderer.js';
 import { renderObservationInboxPage } from '../renderer/observation-inbox-renderer.js';
 import { DEFAULT_LANG, t, layout } from '../renderer/layout.js';
+import { loadAllManagedRecords, resolveManagedDir, managedDir as projectManagedDir, listManagedRows } from '../managed/index.js';
+import { renderManagedList, renderManagedHistory } from '../renderer/managed-history-renderer.js';
+import { DEFAULT_JOBS_DIR } from '../eval-core/default-dirs.js';
+import { resolveObserveHealthDir, projectObserveHealthDir, resolveDoctorsDir, projectDoctorsDir, projectReportsDir, globalReportsDir } from '../eval-core/measurement-dirs.js';
+import { listObserveCards, listDoctorCards, listLiveObserveCards } from '../eval-core/artifact-index.js';
 import { buildSkillIndex } from './skill-index.js';
-import { createFileJobStore, DEFAULT_JOBS_DIR } from './job-store.js';
+import { createFileJobStore } from './job-store.js';
 import { createFileStore, queryJob, queryJobList, queryRun, queryRunList, queryTrend } from './report-store.js';
+import { createIndexedReportStore } from './indexed-report-store.js';
 import { confidenceOf } from '../observability/skill-health-analyzer.js';
 import { DEFAULT_OBSERVATIONS_DIR, findObservationInboxItem, formatObservationShow, queryObservationInbox } from '../observability/inbox.js';
 import { buildObservationInboxViewModel } from '../observability/inbox-view-model.js';
@@ -21,9 +26,6 @@ import { deleteObservationReviewState, loadObservationReviewState, updateObserva
 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)
@@ -42,75 +44,124 @@ function loadChartJsBundle() {
     }
     return cachedChartJsBytes;
 }
-function listAnalyses(dir) {
-    if (!existsSync(dir))
-        return [];
+function listAnalyses(dir, includeCards = false) {
     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)
+    // live 扫描 dir 存在才做;dir 不存在(默认机器级模式下当前项目还没 .omk/observe-health、全局也空)时 live 为空,
+    // 但**不能早退** —— 后面仍要按 includeCards 合并别项目卡片,否则 observe 列表会与合卡片的 /api/skills 口径分裂。
+    if (existsSync(dir)) {
+        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,
+                    // 旧 JSON 缺 confidence 时按 segmentCount 兜底,跟 Studio / CLI 口径一致。
+                    confidence: data.overall.confidence ?? confidenceOf(data.meta.segmentCount),
+                });
+            }
+            catch { /* skip corrupt */ }
+        }
+    }
+    // 别项目的 observe 卡片(当前 dir live 扫不到的项目)→ list item,dedup by id(live 盖卡片)。
+    // 仅机器级模式合并;固定 --analyses-dir / --global 时 includeCards=false,只看该目录(逃生舱语义)。
+    if (includeCards) {
+        const seen = new Set(items.map((i) => i.id));
+        for (const card of listLiveObserveCards()) {
+            if (seen.has(card.id))
                 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,
-                // 旧 JSON 缺 confidence 时按 segmentCount 兜底,跟 Studio / CLI 口径一致。
-                confidence: data.overall.confidence ?? confidenceOf(data.meta.segmentCount),
+                id: card.id, generatedAt: card.meta.generatedAt, sessionCount: card.meta.sessionCount,
+                segmentCount: card.meta.segmentCount, skillCount: Object.keys(card.bySkill).length,
+                healthBand: card.overall.healthBand, confidence: card.overall.confidence ?? confidenceOf(card.meta.segmentCount),
             });
         }
-        catch { /* skip corrupt */ }
     }
     // 最新在前
     items.sort((a, b) => b.generatedAt.localeCompare(a.generatedAt));
     return items;
 }
-function loadAnalysis(dir, id) {
+function loadAnalysis(dir, id, includeCards = false) {
     const path = join(dir, `${id}.json`);
-    if (!existsSync(path))
-        return null;
-    try {
-        return JSON.parse(readFileSync(path, 'utf-8'));
+    if (existsSync(path)) {
+        try {
+            return JSON.parse(readFileSync(path, 'utf-8'));
+        }
+        catch { /* fall through to card */ }
     }
-    catch {
+    // 别项目:按 observe 卡片 path 读真身(含 signals 等完整详情)。悬空(项目被移走)→ null,详情页 404。
+    // 仅机器级模式兜底;固定目录 / --global 不回源别项目卡片(逃生舱语义)。
+    if (!includeCards)
         return null;
+    const card = listObserveCards().find((c) => c.id === id);
+    if (card && existsSync(card.path)) {
+        try {
+            return JSON.parse(readFileSync(card.path, 'utf-8'));
+        }
+        catch { /* corrupt 真身 */ }
     }
+    return null;
 }
 /** 扫 doctorsDir 找 id 匹配的 doctor 报告（文件名不一定等于 report id）。
  *  批量 doctor 会按 skill 拆成多份共享同一 id 的 per-skill 文件，传 skillName 时
  *  优先返回含该 skill 的那份；都不含时回退首个 id 命中（单 skill / 无参行为不变）。 */
-function loadDoctorReport(dir, id, skillName) {
-    if (!existsSync(dir))
-        return null;
+function loadDoctorReport(dir, id, skillName, includeCards = false) {
     let fallback = null;
-    for (const file of readdirSync(dir)) {
-        if (!file.endsWith('.json'))
+    if (existsSync(dir)) {
+        for (const file of readdirSync(dir)) {
+            if (!file.endsWith('.json'))
+                continue;
+            try {
+                const data = JSON.parse(readFileSync(join(dir, file), 'utf-8'));
+                if (data?.kind !== 'doctor' || data.id !== id)
+                    continue;
+                if (!skillName || data.skills?.some((s) => s.skillName === skillName))
+                    return data;
+                fallback ??= data;
+            }
+            catch { /* skip */ }
+        }
+    }
+    if (fallback)
+        return fallback;
+    // 仅机器级模式兜底;固定 --doctors-dir / --global 不回源别项目卡片(逃生舱语义)。
+    if (!includeCards)
+        return null;
+    // 别项目:按 doctor 卡片(reportId 匹配 + 可选 skillName)的 path 读真身。detail 路由传的 id 是 reportId(非卡片 stem)。
+    for (const card of listDoctorCards()) {
+        if (card.reportId !== id)
+            continue;
+        if (skillName && card.skillName !== skillName)
+            continue;
+        if (!existsSync(card.path))
             continue;
         try {
-            const data = JSON.parse(readFileSync(join(dir, file), 'utf-8'));
-            if (data?.kind !== 'doctor' || data.id !== id)
-                continue;
-            if (!skillName || data.skills?.some((s) => s.skillName === skillName))
-                return data;
-            fallback ??= data;
+            const data = JSON.parse(readFileSync(card.path, 'utf-8'));
+            if (data?.kind === 'doctor' && data.id === id) {
+                if (!skillName || data.skills?.some((s) => s.skillName === skillName))
+                    return data;
+                fallback ??= data;
+            }
         }
-        catch { /* skip */ }
+        catch { /* corrupt 真身 */ }
     }
     return fallback;
 }
 /**
  * 扫 analyses/ 所有 JSON,按 skillName 过滤,按时间排序成 trend points。
  */
-function querySkillTrend(dir, skillName) {
-    const items = listAnalyses(dir);
+function querySkillTrend(dir, skillName, includeCards = false) {
+    const items = listAnalyses(dir, includeCards);
     const points = [];
     for (const it of items) {
-        const report = loadAnalysis(dir, it.id);
+        const report = loadAnalysis(dir, it.id, includeCards);
         if (!report)
             continue;
         const h = report.bySkill[skillName];
@@ -144,9 +195,9 @@ function querySkillTrend(dir, skillName) {
  * 比较两份 skill health report. `from` 通常是较早的,`to` 是较晚的;
  * 对于每个 skill, 显示前后值和 delta. 缺失一侧时 presence 标记。
  */
-function querySkillDiff(dir, fromId, toId) {
-    const from = loadAnalysis(dir, fromId);
-    const to = loadAnalysis(dir, toId);
+function querySkillDiff(dir, fromId, toId, includeCards = false) {
+    const from = loadAnalysis(dir, fromId, includeCards);
+    const to = loadAnalysis(dir, toId, includeCards);
     if (!from || !to)
         return null;
     const allSkills = new Set([...Object.keys(from.bySkill), ...Object.keys(to.bySkill)]);
@@ -324,9 +375,9 @@ function renderSkillDiffPage(diff, lang = DEFAULT_LANG) {
     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>
+        <a href="/observe-health${langQ}" data-i18n="backToAnalyses" style="color:var(--accent);text-decoration:none;margin-right:12px">${t('backToAnalyses', lang)}</a>
+        <a href="/observe-health/${encodeURIComponent(fromId)}${langQ}" data-i18n="diffNavFrom" style="color:var(--accent);text-decoration:none;margin-right:12px">${t('diffNavFrom', lang)}</a>
+        <a href="/observe-health/${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">
@@ -352,7 +403,7 @@ function renderSkillTrendPage(trend, lang = DEFAULT_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>
+      <nav style="margin-bottom:12px"><a href="/observe-health${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>`;
@@ -389,7 +440,7 @@ function renderSkillTrendPage(trend, lang = DEFAULT_LANG) {
     <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;font-family:ui-monospace,monospace;font-size:12px"><a href="/observe-health/${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>
@@ -401,7 +452,7 @@ function renderSkillTrendPage(trend, lang = DEFAULT_LANG) {
     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>
+      <nav style="margin-bottom:8px"><a href="/observe-health${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}
@@ -443,7 +494,7 @@ function renderAnalysisList(items, lang = DEFAULT_LANG) {
           <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>
+          <a href="/observe-health/${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>${underpowered ? ` · <span data-i18n="analysesLowN" style="color:var(--text-faint)">${t('analysesLowN', lang)}</span>` : ''}</span>
         </li>`;
             }).join('');
@@ -509,18 +560,51 @@ export function formatListenError(p, err) {
     // 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 } = {}) {
+export function createReportServer({ port, host: hostOption, reportsDir, analysesDir, doctorsDir, observationsDir = DEFAULT_OBSERVATIONS_DIR, jobsDir = DEFAULT_JOBS_DIR, managedDir, store, jobStore, includeObserveCards = false, includeDoctorCards = false } = {}) {
     let server = null;
     let serverUrl = null;
-    // Use provided store or default to file store
-    const reportStore = store || createFileStore(reportsDir);
+    // reports store:显式注入 store > 显式 reportsDir(eval serve 的本次 outputDir / 测试 / 覆盖,固定单目录)
+    // > 缺省 indexed(机器级总览:当前项目 + 全局 live ∪ 别项目的索引卡片,按 id dedup)。indexed 在 store 层做
+    // merge,底层 createFileStore 的 mtime 指纹自动反映内容变化,一次构建即可。
+    const reportStore = store
+        ?? (reportsDir !== undefined
+            ? createFileStore(reportsDir)
+            : createIndexedReportStore({ projectDir: projectReportsDir(), globalDir: globalReportsDir() }));
     const resolvedJobStore = jobStore || createFileJobStore(jobsDir);
+    // 受管根目录按**请求**解析,不在启动时冻结 —— 否则长会话里会跟 omk list 分叉:Studio 启动时项目 .omk/managed
+    // 还空、回退到 global,随后用户在项目里首次 omk install,omk list 下次会切到 project,而冻结了 root 的 Studio
+    // 仍盯着旧 global,页面与 CLI 不一致。cwd 在进程内不变,变的是目录里有没有记录,故每次请求重判。
+    //   - 传函数 → 直接当解析器,每次请求调用(测试可注入受控解析器复现 project↔global 切换);
+    //   - 传字符串 → 固定该目录(显式覆盖 / 测试);
+    //   - 缺省 → 动态解析 project→global 权威目录,与 omk list 同口径。
+    const resolveManagedRoot = typeof managedDir === 'function'
+        ? managedDir
+        : managedDir !== undefined
+            ? () => managedDir
+            : () => resolveManagedDir(projectManagedDir());
+    // observe-health 目录同 managed 按**请求**解析(项目 .omk/observe-health 优先、空则全局兜底) ——
+    // 长会话里项目首次 omk observe 后,studio 下次请求即从 global 切回 project,不在启动时冻结。
+    // 三模式同 managedDir:函数透传 / 字符串固定 / 缺省动态解析。
+    const resolveAnalysesDir = typeof analysesDir === 'function'
+        ? analysesDir
+        : analysesDir !== undefined
+            ? () => analysesDir
+            : () => resolveObserveHealthDir(projectObserveHealthDir());
+    // doctors 目录同 analyses 按请求解析(项目优先→全局兜底),三模式同 managedDir / analysesDir。
+    const resolveDoctorsRoot = typeof doctorsDir === 'function'
+        ? doctorsDir
+        : doctorsDir !== undefined
+            ? () => doctorsDir
+            : () => resolveDoctorsDir(projectDoctorsDir());
     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;
+            // observe-health / doctors 目录每请求解析一次(项目优先→全局兜底),下面各 handler 用这两个 local 字符串。
+            const analysesDir = resolveAnalysesDir();
+            const doctorsDir = resolveDoctorsRoot();
             if (path === '/health') {
                 res.writeHead(200, { 'Content-Type': 'application/json' });
                 res.end(JSON.stringify({ ok: true, service: 'omk' }));
@@ -553,24 +637,87 @@ export function createReportServer({ port, host: hostOption, reportsDir = DEFAUL
                 res.end(JSON.stringify(runs));
                 return;
             }
-            if (path === '/api/analyses') {
+            // 旧 observe 路由 → observe-* 词根 canonical 的兜底(querystring 透传),防外链 / 书签 / 已打开页面的旧 fetch 失效。
+            // 页面用 302(临时);API 用 307 —— review-state 有 POST/DELETE,302 会被客户端降级成 GET,307 保留 method+body。
+            // 复合名 /analyses-diff、/api/analyses-diff、/skill-trend 维持原名,不在此重定向。
+            const legacyObserveRedirect = (() => {
+                if (path === '/analyses')
+                    return { to: '/observe-health', status: 302 };
+                if (path === '/observations' || path === '/observations/inbox')
+                    return { to: '/observe-inbox', status: 302 };
+                const detail = path.match(/^\/analyses\/(.+)$/);
+                if (detail)
+                    return { to: `/observe-health/${detail[1]}`, status: 302 };
+                if (path === '/api/analyses')
+                    return { to: '/api/observe-health', status: 307 };
+                const apiDetail = path.match(/^\/api\/analyses\/(.+)$/);
+                if (apiDetail)
+                    return { to: `/api/observe-health/${apiDetail[1]}`, status: 307 };
+                if (path === '/api/observations/inbox')
+                    return { to: '/api/observe-inbox', status: 307 };
+                if (path === '/api/observations/show')
+                    return { to: '/api/observe-inbox/show', status: 307 };
+                if (path === '/api/observations/diagnostics')
+                    return { to: '/api/observe-inbox/diagnostics', status: 307 };
+                if (path === '/api/observations/review-state')
+                    return { to: '/api/observe-inbox/review-state', status: 307 };
+                return null;
+            })();
+            if (legacyObserveRedirect) {
+                res.writeHead(legacyObserveRedirect.status, { Location: legacyObserveRedirect.to + parsed.search });
+                res.end();
+                return;
+            }
+            if (path === '/api/observe-health') {
                 res.writeHead(200, { 'Content-Type': 'application/json' });
-                res.end(JSON.stringify(listAnalyses(analysesDir)));
+                res.end(JSON.stringify(listAnalyses(analysesDir, includeObserveCards)));
+                return;
+            }
+            if (path === '/observe-health') {
+                res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                res.end(renderAnalysisList(listAnalyses(analysesDir, includeObserveCards), lang));
+                return;
+            }
+            // 受管 skill 决策史（#203 管理支柱可视化出口）。只读受管记录,口径同 omk list。
+            if (path === '/api/managed') {
+                res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
+                res.end(JSON.stringify({ schemaVersion: 1, rows: listManagedRows(resolveManagedRoot()) }));
+                return;
+            }
+            if (path === '/managed') {
+                res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                res.end(renderManagedList(listManagedRows(resolveManagedRoot()), lang));
                 return;
             }
-            if (path === '/analyses') {
+            const managedDetailMatch = path.match(/^\/managed\/(.+)$/);
+            if (managedDetailMatch) {
+                let id;
+                try {
+                    id = decodeURIComponent(managedDetailMatch[1]);
+                }
+                catch {
+                    id = '';
+                }
+                // 按稳定 id(= hash(kind, name)) 精确查 —— 同名不同 kind(skill/review vs prompt/review)各有独立 id,
+                // 不会串到同一页;且只在已加载、已校验的记录里查,不拼文件路径、无路径穿越。
+                const record = id ? loadAllManagedRecords(resolveManagedRoot()).find((r) => r.id === id) : undefined;
+                if (!record) {
+                    res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' });
+                    res.end(lang === 'en' ? 'managed record not found' : '受管记录不存在');
+                    return;
+                }
                 res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
-                res.end(renderAnalysisList(listAnalyses(analysesDir), lang));
+                res.end(renderManagedHistory(record, lang));
                 return;
             }
-            if (path === '/observations' || path === '/observations/inbox') {
+            if (path === '/observe-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') {
+            if (path === '/api/observe-inbox') {
                 const severity = parsed.searchParams.get('severity');
                 const skill = parsed.searchParams.get('skill');
                 const limitRaw = parsed.searchParams.get('limit');
@@ -588,9 +735,9 @@ export function createReportServer({ port, host: hostOption, reportsDir = DEFAUL
                 res.end(JSON.stringify(items));
                 return;
             }
-            if (path === '/api/observations/diagnostics') {
+            if (path === '/api/observe-inbox/diagnostics') {
                 const runs = await reportStore.list();
-                const idx = buildSkillIndex(runs, analysesDir, doctorsDir, observationsDir);
+                const idx = buildSkillIndex(runs, analysesDir, doctorsDir, observationsDir, { includeObserveCards, includeDoctorCards });
                 res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
                 res.end(JSON.stringify({
                     sourceCoverage: idx.diagnosisSummary.sourceCoverage,
@@ -605,14 +752,14 @@ export function createReportServer({ port, host: hostOption, reportsDir = DEFAUL
                 }));
                 return;
             }
-            if (path === '/api/observations/show') {
+            if (path === '/api/observe-inbox/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 (path === '/api/observe-inbox/review-state') {
                 if (req.method === 'GET') {
                     res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
                     res.end(JSON.stringify(loadObservationReviewState(observationsDir)));
@@ -667,7 +814,7 @@ export function createReportServer({ port, host: hostOption, reportsDir = DEFAUL
             if (doctorDetailMatch) {
                 const id = decodeURIComponent(doctorDetailMatch[1]);
                 const skillName = parsed.searchParams.get('skill') ?? '';
-                const report = loadDoctorReport(doctorsDir, id, skillName || undefined);
+                const report = loadDoctorReport(doctorsDir, id, skillName || undefined, includeDoctorCards);
                 if (!report) {
                     res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' });
                     res.end(lang === 'en' ? 'doctor report not found' : '体检报告不存在');
@@ -676,7 +823,7 @@ export function createReportServer({ port, host: hostOption, reportsDir = DEFAUL
                 let ctx;
                 if (skillName) {
                     const runs = await reportStore.list();
-                    const idx = buildSkillIndex(runs, analysesDir, doctorsDir, observationsDir);
+                    const idx = buildSkillIndex(runs, analysesDir, doctorsDir, observationsDir, { includeObserveCards, includeDoctorCards });
                     const entry = idx.entries.find((en) => en.skillName === skillName);
                     if (entry)
                         ctx = buildSkillContext(entry, 'doctor', id, idx.insightsBySkill.get(entry.skillName) ?? [], lang);
@@ -686,10 +833,10 @@ export function createReportServer({ port, host: hostOption, reportsDir = DEFAUL
                 res.end(renderDoctorDetail(report, skillName, langQ, lang, ctx));
                 return;
             }
-            const analysisDetailMatch = path.match(/^\/analyses\/(.+)$/);
+            const analysisDetailMatch = path.match(/^\/observe-health\/(.+)$/);
             if (analysisDetailMatch) {
                 const id = decodeURIComponent(analysisDetailMatch[1]);
-                const report = loadAnalysis(analysesDir, id);
+                const report = loadAnalysis(analysesDir, id, includeObserveCards);
                 if (!report) {
                     res.writeHead(404, { 'Content-Type': 'text/plain' });
                     res.end('analysis not found');
@@ -699,10 +846,10 @@ export function createReportServer({ port, host: hostOption, reportsDir = DEFAUL
                 res.end(renderSkillHealthReport(report, lang));
                 return;
             }
-            const analysisApiMatch = path.match(/^\/api\/analyses\/(.+)$/);
+            const analysisApiMatch = path.match(/^\/api\/observe-health\/(.+)$/);
             if (analysisApiMatch) {
                 const id = decodeURIComponent(analysisApiMatch[1]);
-                const report = loadAnalysis(analysesDir, id);
+                const report = loadAnalysis(analysesDir, id, includeObserveCards);
                 if (!report) {
                     res.writeHead(404, { 'Content-Type': 'application/json' });
                     res.end(JSON.stringify({ error: 'analysis not found' }));
@@ -716,14 +863,14 @@ export function createReportServer({ port, host: hostOption, reportsDir = DEFAUL
             if (skillTrendApiMatch) {
                 const skillName = decodeURIComponent(skillTrendApiMatch[1]);
                 res.writeHead(200, { 'Content-Type': 'application/json' });
-                res.end(JSON.stringify(querySkillTrend(analysesDir, skillName)));
+                res.end(JSON.stringify(querySkillTrend(analysesDir, skillName, includeObserveCards)));
                 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));
+                res.end(renderSkillTrendPage(querySkillTrend(analysesDir, skillName, includeObserveCards), lang));
                 return;
             }
             if (path === '/analyses-diff') {
@@ -734,7 +881,7 @@ export function createReportServer({ port, host: hostOption, reportsDir = DEFAUL
                     res.end('missing from/to query params');
                     return;
                 }
-                const diff = querySkillDiff(analysesDir, fromId, toId);
+                const diff = querySkillDiff(analysesDir, fromId, toId, includeObserveCards);
                 if (!diff) {
                     res.writeHead(404, { 'Content-Type': 'text/plain' });
                     res.end('analysis not found');
@@ -752,7 +899,7 @@ export function createReportServer({ port, host: hostOption, reportsDir = DEFAUL
                     res.end(JSON.stringify({ error: 'missing from/to query params' }));
                     return;
                 }
-                const diff = querySkillDiff(analysesDir, fromId, toId);
+                const diff = querySkillDiff(analysesDir, fromId, toId, includeObserveCards);
                 if (!diff) {
                     res.writeHead(404, { 'Content-Type': 'application/json' });
                     res.end(JSON.stringify({ error: 'analysis not found' }));
@@ -838,7 +985,7 @@ export function createReportServer({ port, host: hostOption, reportsDir = DEFAUL
                 let ctx;
                 if (report && report.kind === 'evaluation') {
                     const runs = await reportStore.list();
-                    const idx = buildSkillIndex(runs, analysesDir, doctorsDir, observationsDir);
+                    const idx = buildSkillIndex(runs, analysesDir, doctorsDir, observationsDir, { includeObserveCards, includeDoctorCards });
                     // 按 evalHistory 匹配(非仅最新),历史 eval 报告也能定位到所属 skill。
                     const entry = idx.entries.find((en) => en.evalHistory.some((h) => h.reportId === reportId));
                     if (entry)
@@ -860,14 +1007,14 @@ export function createReportServer({ port, host: hostOption, reportsDir = DEFAUL
             // list renderer 直接消费,不再每请求 N×detectInsights 重算。
             if (path === '/') {
                 const runs = await reportStore.list();
-                const idx = buildSkillIndex(runs, analysesDir, doctorsDir, observationsDir);
+                const idx = buildSkillIndex(runs, analysesDir, doctorsDir, observationsDir, { includeObserveCards, includeDoctorCards });
                 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);
+                const idx = buildSkillIndex(runs, analysesDir, doctorsDir, observationsDir, { includeObserveCards, includeDoctorCards });
                 res.writeHead(200, { 'Content-Type': 'application/json; charset=utf-8' });
                 res.end(JSON.stringify({
                     entries: idx.entries.map((entry) => ({
@@ -888,7 +1035,7 @@ export function createReportServer({ port, host: hostOption, reportsDir = DEFAUL
             if (skillDiagnosticsApiMatch) {
                 const skillName = decodeURIComponent(skillDiagnosticsApiMatch[1]);
                 const runs = await reportStore.list();
-                const idx = buildSkillIndex(runs, analysesDir, doctorsDir, observationsDir);
+                const idx = buildSkillIndex(runs, analysesDir, doctorsDir, observationsDir, { includeObserveCards, includeDoctorCards });
                 const diagnostics = idx.diagnosticsBySkill.get(skillName);
                 if (!diagnostics) {
                     res.writeHead(404, { 'Content-Type': 'application/json; charset=utf-8' });
@@ -918,10 +1065,9 @@ export function createReportServer({ port, host: hostOption, reportsDir = DEFAUL
     async function start() {
         if (server)
             return serverUrl;
-        if (!existsSync(reportsDir))
-            mkdirSync(reportsDir, { recursive: true });
-        if (!existsSync(analysesDir))
-            mkdirSync(analysesDir, { recursive: true });
+        // reports / analyses / doctors 都不在启动时 mkdir —— studio 只读消费,readers 都 existsSync 守卫、
+        // writer(omk eval / observe / doctor)各自建目录;reports 默认走 overlay(项目盖全局),启动时往随机
+        // cwd 建空 .omk/reports 既无意义又是噪声。observationsDir / jobsDir 仍预建(既有行为)。
         if (!existsSync(observationsDir))
             mkdirSync(observationsDir, { recursive: true });
         if (!existsSync(jobsDir))