oh-my-knowledge 0.37.0 → 0.38.0

package/dist/executors/script.js

@@ -1,5 +1,6 @@
 import { existsSync } from 'node:fs';
 import { isAbsolute, resolve } from 'node:path';
+import { materializeForCliConfigDir } from '../eval-core/mocks-runtime.js';
 import { DEFAULT_TIMEOUT_MS, interruptedExecResult, spawnWithSigintPropagation, timeoutExecResult, } from './shared.js';
 // script executor 由用户自定义,omk 无法保证它实现 skill 隔离。
 // 任何 allowedSkills(包括 [])下都 stderr 一次性 warn,不阻塞执行,
@@ -20,7 +21,7 @@ export function createScriptExecutor(command) {
     const args = parts.slice(1)
         .map((a) => a.replace(/^["']|["']$/g, ''))
         .map((a) => resolveExecutorPath(a, baseCwd));
-    return async function scriptExecutor({ model, system, prompt, cwd, timeoutMs = DEFAULT_TIMEOUT_MS, allowedSkills }) {
+    return async function scriptExecutor({ model, system, prompt, cwd, timeoutMs = DEFAULT_TIMEOUT_MS, allowedSkills, mocks, mocksBaseDir, mocksStrict }) {
         if (allowedSkills !== undefined && !scriptIsolationWarned) {
             scriptIsolationWarned = true;
             process.stderr.write(`[omk] script executor 不参与 skill isolation:allowedSkills=${JSON.stringify(allowedSkills)} 在自定义 executor "${command}" 下无效。\n`
@@ -28,8 +29,38 @@ export function createScriptExecutor(command) {
         }
         const input = JSON.stringify({ model, system: system || '', prompt });
         const start = Date.now();
+        // mock 注入:复用 claude-cli 的物化逻辑(临时目录 + on-disk hook + mocks.json),把
+        // settings / mcp-config / mocks 文件路径通过 env 暴露给脚本。脚本若包的是 Claude Code
+        // 兼容 CLI,自行把 OMK_MOCK_SETTINGS_FILE 透传成 `--settings`(或把其中的 hook 打包成
+        // `--plugin-dir` 插件)即可复用 omk 的 PreToolUse mock hook;不支持的脚本忽略这些 env
+        // 即可(向后兼容)。env 是局部对象、不改 process.env,并发多 eval 各 spawn 独立快照、
+        // 互不串台;临时目录由 mkdtemp 唯一命名,finally 里 cleanup 删除。
+        const mockHandle = mocks && mocks.length > 0
+            ? materializeForCliConfigDir(mocks, mocksBaseDir, !!mocksStrict)
+            : null;
+        const env = { ...process.env };
+        if (mockHandle) {
+            Object.assign(env, mockHandle.env); // OMK_MOCKS_FILE
+            env.OMK_MOCK_SETTINGS_FILE = mockHandle.settingsFile;
+            if (mockHandle.mcpConfigFile)
+                env.OMK_MOCK_MCP_CONFIG_FILE = mockHandle.mcpConfigFile;
+        }
+        // 与 claude-cli / claude-sdk 对齐:每条返回路径(成功/解析失败/超时/中断/错误)都回填
+        // mockStats,出错样本也能看到 mock 命中统计。readStats 内部已对缺文件/坏 JSON 兜底,
+        // 这里再包一层 try/catch 防御(不让取统计反而把成功结果带崩)。必须在 finally cleanup
+        // 删临时目录之前读 —— return 表达式先求值,再走 finally,顺序正确。
+        const captureMockStats = () => {
+            if (!mockHandle)
+                return undefined;
+            try {
+                return mockHandle.readStats();
+            }
+            catch {
+                return undefined;
+            }
+        };
         const { child, done } = spawnWithSigintPropagation(cmd, args, {
-            env: { ...process.env },
+            env,
             timeoutMs,
             ...(cwd && { cwd }),
         });
@@ -38,6 +69,7 @@ export function createScriptExecutor(command) {
         try {
             const r = await done;
             const durationMs = Date.now() - start;
+            const ms = captureMockStats();
             try {
                 const data = JSON.parse(r.stdout);
                 return {
@@ -46,6 +78,7 @@ export function createScriptExecutor(command) {
                     inputTokens: data.inputTokens || 0, outputTokens: data.outputTokens || 0,
                     cacheReadTokens: data.cacheReadTokens || 0, cacheCreationTokens: data.cacheCreationTokens || 0,
                     costUSD: data.costUSD || 0, stopReason: data.stopReason || 'end', numTurns: data.numTurns || 1,
+                    ...(ms && { mockStats: ms }),
                 };
             }
             catch {
@@ -53,16 +86,18 @@ export function createScriptExecutor(command) {
                     ok: true, output: r.stdout.trim(), durationMs, durationApiMs: 0,
                     inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheCreationTokens: 0,
                     costUSD: 0, stopReason: 'end', numTurns: 1,
+                    ...(ms && { mockStats: ms }),
                 };
             }
         }
         catch (err) {
             const durationMs = Date.now() - start;
+            const ms = captureMockStats();
             const details = err;
             if (details.killedByTimeout)
-                return timeoutExecResult(timeoutMs, durationMs);
+                return { ...timeoutExecResult(timeoutMs, durationMs), ...(ms && { mockStats: ms }) };
             if (details.killedBySignal)
-                return interruptedExecResult(durationMs);
+                return { ...interruptedExecResult(durationMs), ...(ms && { mockStats: ms }) };
             const stderr = (details.stderr || '').trim();
             return {
                 ok: false,
@@ -70,7 +105,11 @@ export function createScriptExecutor(command) {
                 durationMs, durationApiMs: 0,
                 inputTokens: 0, outputTokens: 0, cacheReadTokens: 0, cacheCreationTokens: 0,
                 costUSD: 0, output: null, stopReason: 'error', numTurns: 0,
+                ...(ms && { mockStats: ms }),
             };
         }
+        finally {
+            mockHandle?.cleanup();
+        }
     };
 }

package/dist/inputs/materialize-copy.d.ts

@@ -11,7 +11,7 @@ export interface IsolatedCopy {
     contentHash: string;
     isDirectorySkill: boolean;
 }
-/** 隔离副本根目录(与 managed / isolated-cwd / reports 同 home-dir 模式)。
+/** 隔离副本根目录 —— 可重生 scratch,收在 state/ 子树下(见 default-dirs)。
  *  `OMK_TREES_DIR` 可重定位(测试隔离 / 用户迁移)。 */
 export declare function treesDir(): string;
 /**

package/dist/inputs/materialize-copy.js

@@ -1,11 +1,11 @@
 import { mkdtempSync, mkdirSync, cpSync, copyFileSync, existsSync, renameSync, rmSync, readdirSync, statSync, utimesSync, writeFileSync, unlinkSync } from 'node:fs';
 import { basename, join } from 'node:path';
-import { homedir } from 'node:os';
 import { hashArtifactSource, distributableCopyFilter } from './content-hash.js';
-/** 隔离副本根目录(与 managed / isolated-cwd / reports 同 home-dir 模式)。
+import { DEFAULT_TREES_DIR } from '../eval-core/default-dirs.js';
+/** 隔离副本根目录 —— 可重生 scratch,收在 state/ 子树下(见 default-dirs)。
  *  `OMK_TREES_DIR` 可重定位(测试隔离 / 用户迁移)。 */
 export function treesDir() {
-    return process.env.OMK_TREES_DIR || join(homedir(), '.oh-my-knowledge', 'trees');
+    return process.env.OMK_TREES_DIR || DEFAULT_TREES_DIR;
 }
 /** 内容寻址副本默认上限(distinct 内容版本数);超出按 LRU(mtime)淘汰。
  *  `OMK_TREES_MAX_ENTRIES` 调整:0 / 负数 = 不限。 */

package/dist/inputs/skill-loader.d.ts

@@ -134,7 +134,7 @@ export interface ResolveArtifactsOptions {
      *  显式 per-variant 隔离声明走 spec.allowedSkills(prepareEvaluationRun 按 spec 身份绑定),
      *  不经此处——resolveArtifacts 只认 strictBaseline 默认,隔离绑定收成单一来源。 */
     strictBaseline?: boolean;
-    /** Default true. dir-skill 是否落地隔离副本(写 `~/.oh-my-knowledge/trees` 并设 execRoot)。
+    /** Default true. dir-skill 是否落地隔离副本(写 `~/.oh-my-knowledge/state/trees` 并设 execRoot)。
      *  只有 eval(执行隔离)需要;doctor / loadSkills 等纯读路径传 false,只算指纹与正文、不写副本。 */
     materialize?: boolean;
 }

package/dist/inputs/skill-loader.js

@@ -511,7 +511,7 @@ export function variantExprToSkillName(expr) {
  * 本地源 localDir 是真源目录;git 源 localDir 是 materializeGitSkillTree 物化出的临时目录。
  * execRoot(副本)供 executor cwd / skillDir 锚定;skillRoot(真源)由各分支自行保留。
  * 只有 eval 路径需要副本(执行隔离);doctor / loadSkills 只需指纹与正文,materialize=false 不落副本、
- * 不写 `~/.oh-my-knowledge/trees`(避免纯读路径的副作用 I/O 与 trees 污染)。
+ * 不写 `~/.oh-my-knowledge/state/trees`(避免纯读路径的副作用 I/O 与 trees 污染)。
  */
 function isolateDirSkill(localDir, name, materialize) {
     const content = readFileSync(join(localDir, 'SKILL.md'), 'utf-8').trim();

package/dist/managed/index.d.ts

@@ -5,4 +5,6 @@
 export * from './store.js';
 export * from './evidence.js';
 export * from './list-view.js';
+export * from './list-query.js';
+export * from './source-probe.js';
 export * from './promote-gate.js';

package/dist/managed/index.js

@@ -5,4 +5,6 @@
 export * from './store.js';
 export * from './evidence.js';
 export * from './list-view.js';
+export * from './list-query.js';
+export * from './source-probe.js';
 export * from './promote-gate.js';

package/dist/managed/list-query.d.ts

@@ -0,0 +1,7 @@
+import { type ManagedListRow } from './list-view.js';
+/**
+ * 「读受管记录做展示」的单一编排:load 全部记录 → 逐条源探测(drift / 生命周期)→ 展示行。
+ * omk list(CLI) 与 Studio(report-server) 共用同一口径,避免两个交付层各串一份。
+ * dir 省略时走 loadAllManagedRecords 的 project→global 回退。
+ */
+export declare function listManagedRows(dir?: string): ManagedListRow[];

package/dist/managed/list-query.js

@@ -0,0 +1,11 @@
+import { buildManagedListRows } from './list-view.js';
+import { loadAllManagedRecords } from './store.js';
+import { probeSourceState } from './source-probe.js';
+/**
+ * 「读受管记录做展示」的单一编排:load 全部记录 → 逐条源探测(drift / 生命周期)→ 展示行。
+ * omk list(CLI) 与 Studio(report-server) 共用同一口径,避免两个交付层各串一份。
+ * dir 省略时走 loadAllManagedRecords 的 project→global 回退。
+ */
+export function listManagedRows(dir) {
+    return buildManagedListRows(loadAllManagedRecords(dir), probeSourceState);
+}

package/dist/managed/source-probe.d.ts

@@ -0,0 +1,15 @@
+import type { SourceProbe } from './list-view.js';
+import type { ManagedArtifactRecord } from '../types/index.js';
+/**
+ * 探测一条受管记录**当前源**的状态(三态,喂 buildManagedListRow 判 drift / 生命周期)。
+ *   - 远端 git(带 url):源身份钉不可变 SHA(install 时 pin),内容恒定 → 直接取 record.contentHash,
+ *     不联网(快读命令不为 drift 检查发网络请求)。reachable。
+ *   - 本地 git:locator `git:<ref>:<spec>` 复用 resolveInstallSource 在**仓库对象库**内重物化重哈
+ *     (读取受 git 边界约束,无任意文件读 DoS)。解析不到(常因 cwd 与 install 时不同、spec 随 cwd 漂)
+ *     → 抛错 → **reachable:false(未核,不当 stale)**,避免对未改动的 skill 误报漂移。
+ *   - 本地 file:locator 是绝对路径,但受管 JSON **用户可手改 / 随仓库分发**(无 install、无 opt-in 即被
+ *     loadAllManagedRecords 读到)。只读命令绝不盲读任意路径:**拒软链、只读常规文件 / 真目录、单文件
+ *     设 size cap**(挡 `evil.md → /dev/zero` 这类 readFileSync 无界 DoS 与项目外任意读)。守卫不过 →
+ *     reachable:false。目录-skill 整树哈本就跳软链(hashArtifactSource 用 isFile() 过滤)。
+ */
+export declare function probeSourceState(record: ManagedArtifactRecord): SourceProbe;

package/dist/managed/source-probe.js

@@ -0,0 +1,129 @@
+import { existsSync, lstatSync, readdirSync } from 'node:fs';
+import { isAbsolute, resolve, join } from 'node:path';
+import { resolveInstallSource } from '../inputs/source-resolver.js';
+import { hashArtifactSource, isDistributablePath } from '../inputs/content-hash.js';
+/**
+ * 受管记录**当前源**的状态探测——`omk list`(drift / 生命周期)与 `omk promote`(门禁前先确认源未漂)共用
+ * 的单一来源。两命令必须用同一套守卫与 drift 判定:否则 list 显示「未漂」而 promote 判「漂」(或反之)会
+ * 互相矛盾,且安全守卫一旦各写一份必然漂掉一份。
+ *
+ * 本地源读取成本上限:skill 是小体量 markdown(+少量 references 资产),远超这些边界的源必是手改 / 投毒,
+ * 拒读避免只读命令(读盘上可能随仓库分发的 locator)被 /dev/zero / 超大文件 / 巨型目录递归拖垮(DoS)。
+ */
+const MAX_FILE_SOURCE_BYTES = 8 * 1024 * 1024; // 单文件-skill 上限
+const MAX_DIR_SOURCE_BYTES = 64 * 1024 * 1024; // 目录-skill 整树累计上限
+const MAX_DIR_SOURCE_FILES = 4000; // 目录-skill 文件数上限
+const MAX_DIR_SOURCE_DEPTH = 64; // 目录递归深度上限
+/**
+ * 目录-skill 源的**有边界**整树哈:先恢复 resolveFileSource 的形态校验(SKILL.md 存在、是常规文件、非
+ * 软链 —— 否则 locator 可指向任意可读目录让递归读整棵树),再 stat-walk(只 stat 不读)按与
+ * hashArtifactSource 同一 `isDistributablePath` 过滤累计 文件数 / 字节 / 深度,超界即返回 null(unreachable),
+ * 把单文件 DoS 不再换成目录递归 DoS。通过后才真正 hashArtifactSource。返回 null = 拒读 / 非法 skill 目录。
+ */
+function boundedDirSkillHash(abs) {
+    const skillMd = join(abs, 'SKILL.md');
+    let md;
+    try {
+        md = lstatSync(skillMd);
+    }
+    catch {
+        return null; // 无 SKILL.md → 不是 skill 目录,拒
+    }
+    if (md.isSymbolicLink() || !md.isFile() || md.nlink !== 1)
+        return null; // SKILL.md 必须是常规、非软链、非硬链
+    let files = 0;
+    let bytes = 0;
+    const within = (dir, segs, depth) => {
+        if (depth > MAX_DIR_SOURCE_DEPTH)
+            return false;
+        let entries;
+        try {
+            entries = readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return false;
+        }
+        for (const e of entries) {
+            const ns = [...segs, e.name];
+            if (!isDistributablePath(ns))
+                continue; // 与 hashArtifactSource 读取范围一致
+            if (e.isDirectory()) {
+                if (!within(join(dir, e.name), ns, depth + 1))
+                    return false;
+            }
+            else if (e.isFile()) { // 软链 Dirent 既非 isFile 也非 isDirectory → 天然跳过
+                if (++files > MAX_DIR_SOURCE_FILES)
+                    return false;
+                try {
+                    const fst = lstatSync(join(dir, e.name));
+                    if (fst.nlink !== 1)
+                        return false; // 硬链(nlink>1)可在树内别名树外敏感 inode → 拒读整树
+                    bytes += fst.size;
+                }
+                catch {
+                    return false;
+                }
+                if (bytes > MAX_DIR_SOURCE_BYTES)
+                    return false;
+            }
+        }
+        return true;
+    };
+    if (!within(abs, [], 0))
+        return null;
+    return hashArtifactSource(abs, true);
+}
+/**
+ * 探测一条受管记录**当前源**的状态(三态,喂 buildManagedListRow 判 drift / 生命周期)。
+ *   - 远端 git(带 url):源身份钉不可变 SHA(install 时 pin),内容恒定 → 直接取 record.contentHash,
+ *     不联网(快读命令不为 drift 检查发网络请求)。reachable。
+ *   - 本地 git:locator `git:<ref>:<spec>` 复用 resolveInstallSource 在**仓库对象库**内重物化重哈
+ *     (读取受 git 边界约束,无任意文件读 DoS)。解析不到(常因 cwd 与 install 时不同、spec 随 cwd 漂)
+ *     → 抛错 → **reachable:false(未核,不当 stale)**,避免对未改动的 skill 误报漂移。
+ *   - 本地 file:locator 是绝对路径,但受管 JSON **用户可手改 / 随仓库分发**(无 install、无 opt-in 即被
+ *     loadAllManagedRecords 读到)。只读命令绝不盲读任意路径:**拒软链、只读常规文件 / 真目录、单文件
+ *     设 size cap**(挡 `evil.md → /dev/zero` 这类 readFileSync 无界 DoS 与项目外任意读)。守卫不过 →
+ *     reachable:false。目录-skill 整树哈本就跳软链(hashArtifactSource 用 isFile() 过滤)。
+ */
+export function probeSourceState(record) {
+    const s = record.source;
+    if (s.sourceKind === 'git' && s.url)
+        return { reachable: true, hash: record.contentHash };
+    try {
+        if (s.sourceKind === 'git') {
+            const resolved = resolveInstallSource(s.locator);
+            try {
+                return { reachable: true, hash: hashArtifactSource(resolved.localRoot, resolved.isDirectorySkill) };
+            }
+            finally {
+                resolved.cleanup();
+            }
+        }
+        // 本地 file 源:守卫后再读。locator 必须是 install 实际写出的形态(绝对路径) —— 受管 JSON 随仓库
+        // 分发、无 opt-in 即被读到,相对 locator 不是 install 产物,拒,避免按 cwd 解析到项目外。
+        if (!isAbsolute(s.locator))
+            return { reachable: false };
+        const abs = resolve(s.locator);
+        if (!existsSync(abs))
+            return { reachable: false };
+        const st = lstatSync(abs); // lstat:不跟随软链 —— 软链直接拒(防 evil.md → /dev/zero)
+        if (st.isSymbolicLink())
+            return { reachable: false };
+        if (s.isDirectorySkill) {
+            if (!st.isDirectory())
+                return { reachable: false };
+            const hash = boundedDirSkillHash(abs); // 形态校验 + 成本边界(防任意目录递归读 / 目录 DoS)
+            return hash === null ? { reachable: false } : { reachable: true, hash };
+        }
+        // 单文件-skill:恢复 install(resolveFileSource)的形态约束 —— 必须是 `.md` 常规文件、非硬链、≤ size cap。
+        // 否则攻击者可写 locator:`/etc/passwd` / `~/.ssh/id_rsa`(非 .md 直接拒),或用 `.md` 命名的**硬链**别名
+        // 树外敏感文件绕过扩展名 / 软链守卫(lstat 分不出硬链)→ 诱 list 把任意本地文件读进进程参与 hash。install
+        // 写出的是 nlink=1 的全新副本,拒 nlink>1 不误伤合法源。非 install 形态一律 reachable:false。
+        if (!/\.md$/i.test(abs) || !st.isFile() || st.nlink !== 1 || st.size > MAX_FILE_SOURCE_BYTES)
+            return { reachable: false };
+        return { reachable: true, hash: hashArtifactSource(abs, false) };
+    }
+    catch {
+        return { reachable: false };
+    }
+}

package/dist/managed/store.d.ts

@@ -44,6 +44,16 @@ export declare function upsertManagedRecord(dir: string, record: ManagedArtifact
  * null —— 这是"管理是 install 显式 opt-in"的体现:eval 绝不为未纳管的 skill 凭空建记录。
  */
 export declare function appendManagedEvidence(dir: string, recordId: string, evidence: ManagedEvidenceRef): ManagedArtifactRecord | null;
+/**
+ * 把受管记录的 drift 基线(contentHash)重锚到新源内容哈,保留 evidence / decisions / source /
+ * distribution 全不动。用于 `omk evolve` 把胜出版本写回 source 后,让记录跟上实际内容——否则记录的
+ * contentHash 仍指旧基线,list 会把被 evolve 改过的受管 skill 永久显示成 stale。
+ *
+ * 只动 contentHash:旧 hash 锚定的旧 evidence / promote 决定自动变「非当前」(其 contentHash ≠ 新基线)=
+ * 历史,不再冒充当前状态;新内容的证据 / 决定由调用方另行 append。已经是该 hash → no-op 不重写。记录不存在
+ * 返回 null(同 evidence / decision:管理是 install 显式 opt-in)。
+ */
+export declare function rebaselineManagedContentHash(dir: string, recordId: string, newHash: string): ManagedArtifactRecord | null;
 /**
  * 当前内容(contentHash === record.contentHash)是否处于 promoted 态。决定是 append-only 事件流,
  * promote 与 rollback 互为反操作,故不能看「是否存在过 promote」,而要看**当前内容最近一条** promote/rollback

package/dist/managed/store.js

@@ -1,7 +1,7 @@
 import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
 import { join, normalize } from 'node:path';
 import { hashString } from '../eval-core/evaluation-reporting.js';
+import { OMK_HOME } from '../eval-core/default-dirs.js';
 /**
  * 受管记录的 per-record 文件存储。一条记录一个 `.omk/managed/<id>.json`,镜像 report-store 的
  * 成熟模式(原子 tmp+rename):每次 install 只碰自己那个文件,independent write、不丢别人、
@@ -16,7 +16,7 @@ export function managedDir(cwd = process.cwd()) {
     return join(cwd, '.omk', 'managed');
 }
 export function globalManagedDir() {
-    return join(homedir(), '.oh-my-knowledge', 'managed');
+    return join(OMK_HOME, 'managed');
 }
 export function recordPath(dir, id) {
     return join(dir, `${id}.json`);
@@ -239,6 +239,29 @@ export function appendManagedEvidence(dir, recordId, evidence) {
     }
     return merged;
 }
+/**
+ * 把受管记录的 drift 基线(contentHash)重锚到新源内容哈,保留 evidence / decisions / source /
+ * distribution 全不动。用于 `omk evolve` 把胜出版本写回 source 后,让记录跟上实际内容——否则记录的
+ * contentHash 仍指旧基线,list 会把被 evolve 改过的受管 skill 永久显示成 stale。
+ *
+ * 只动 contentHash:旧 hash 锚定的旧 evidence / promote 决定自动变「非当前」(其 contentHash ≠ 新基线)=
+ * 历史,不再冒充当前状态;新内容的证据 / 决定由调用方另行 append。已经是该 hash → no-op 不重写。记录不存在
+ * 返回 null(同 evidence / decision:管理是 install 显式 opt-in)。
+ */
+export function rebaselineManagedContentHash(dir, recordId, newHash) {
+    const prev = loadManagedRecord(dir, recordId);
+    if (!prev)
+        return null;
+    if (prev.contentHash === newHash)
+        return prev;
+    const merged = { ...prev, contentHash: newHash };
+    mkdirSync(dir, { recursive: true });
+    const path = recordPath(dir, recordId);
+    const tmp = `${path}.tmp.${process.pid}.${Date.now()}`;
+    writeFileSync(tmp, JSON.stringify(merged, null, 2));
+    renameSync(tmp, path);
+    return merged;
+}
 /**
  * 当前内容(contentHash === record.contentHash)是否处于 promoted 态。决定是 append-only 事件流,
  * promote 与 rollback 互为反操作,故不能看「是否存在过 promote」,而要看**当前内容最近一条** promote/rollback

package/dist/observability/inbox.js

@@ -1,14 +1,17 @@
 import { createHash } from 'node:crypto';
 import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
 import { join } from 'node:path';
+import { OMK_HOME } from '../eval-core/default-dirs.js';
 import { extractGapSignalsFromTrace } from '../analysis/gap-analyzer.js';
 import { ccTracesToResultEntries } from './trace-adapter.js';
 import { isSearchToolCall, toolCallQuery } from '../shared/tool-search.js';
 import { durationMsBetween } from '../shared/time.js';
 import { buildObservationExperienceReport, normalizeObservationExperienceReport, } from './experience.js';
-export const DEFAULT_PROJECT_OBSERVATIONS_DIR = join(process.cwd(), '.omk', 'observations');
-export const DEFAULT_GLOBAL_OBSERVATIONS_DIR = join(homedir(), '.oh-my-knowledge', 'observations');
+// observe inbox（观测收件箱）产物根目录。导出名沿用 *_OBSERVATIONS_DIR 以少动 importer,
+// 但落盘目录已统一到 observe-inbox 词根(命令 omk observe inbox / 文件 *-observe-inbox.json / kind observe-inbox)。
+// 项目级 .omk/observe-inbox 优先、全局兜底 —— 这套 project/global 归属是既有正常行为,本次只改名不改归属。
+export const DEFAULT_PROJECT_OBSERVATIONS_DIR = join(process.cwd(), '.omk', 'observe-inbox');
+export const DEFAULT_GLOBAL_OBSERVATIONS_DIR = join(OMK_HOME, 'observe-inbox');
 export const DEFAULT_OBSERVATIONS_DIR = DEFAULT_PROJECT_OBSERVATIONS_DIR;
 const OBSERVATION_INBOX_SCHEMA_VERSION = 2;
 function hashString(input) {

package/dist/observability/skill-health-analyzer.d.ts

@@ -52,6 +52,9 @@ export interface SkillHealth {
     gap: GapReport;
 }
 export interface SkillHealthReport {
+    /** 顶层判别字段,与 observe-inbox / observe-experience 同属 observe-* 报告族。
+     *  可选:历史文件无此字段,reader 靠 meta+overall 识别,不强制(additive,非 BREAKING-SCHEMA)。 */
+    kind?: 'observe-health';
     meta: {
         tracePath: string;
         kbPath: string | null;

package/dist/observability/skill-health-analyzer.js

@@ -168,6 +168,7 @@ export function computeSkillHealthReport(tracePath, opts = {}) {
         }
         : { from: '', to: '' };
     return {
+        kind: 'observe-health',
         meta: {
             tracePath,
             kbPath: kbRoot,
@@ -235,6 +236,7 @@ function buildReport(segments, entries, sessions, tracePath, opts) {
         }
         : { from: '', to: '' };
     return {
+        kind: 'observe-health',
         meta: {
             tracePath,
             kbPath: kbRoot,

package/dist/renderer/html-renderer.js

@@ -134,7 +134,7 @@ function renderRuntimeFingerprintTags(meta, lang) {
 }
 export function renderRunList(runs, lang = DEFAULT_LANG) {
     const langQ = lang === DEFAULT_LANG ? '' : `?lang=${lang}`;
-    const skillHealthLink = `<a class="page-secondary-link" href="/analyses${langQ}">📊 <span data-i18n="skillHealthTitle">${t('skillHealthTitle', lang)}</span> →</a>`;
+    const skillHealthLink = `<a class="page-secondary-link" href="/observe-health${langQ}">📊 <span data-i18n="skillHealthTitle">${t('skillHealthTitle', lang)}</span> →</a>`;
     if (!runs || runs.length === 0) {
         return layout(t('title', lang), `
       <main>
@@ -149,7 +149,9 @@ export function renderRunList(runs, lang = DEFAULT_LANG) {
     // 顶部 verdict pill 主导视觉,id+date 是身份,scores 是成绩,底部 meta 是元数据,
     // delete 默认隐藏在 hover 出现避免误点。批量报告共用同一组件,batch pill 替代 verdict。
     const formatDateFromId = (id, fallbackTs) => {
-        const idMatch = id.match(/(\d{4})(\d{2})(\d{2})-(\d{2})(\d{2})$/);
+        // 兼容两代 run id 后缀:旧 `…YYYYMMDD-HHmm`、新 `…YYYYMMDD-HHmmss-rand4`(含秒+随机)。
+        // 都从 id 直接派生本地展示时间(确定性,不走时区敏感的 toLocaleString);新增的秒段 + 随机后缀可选匹配。
+        const idMatch = id.match(/(\d{4})(\d{2})(\d{2})-(\d{2})(\d{2})(?:\d{2}-[a-z0-9]+)?$/);
         if (idMatch)
             return `${idMatch[2]}/${idMatch[3]} ${idMatch[4]}:${idMatch[5]}`;
         return fallbackTs ? new Date(fallbackTs).toLocaleString('zh-CN', { month: '2-digit', day: '2-digit', hour: '2-digit', minute: '2-digit' }) : '';

package/dist/renderer/managed-history-renderer.d.ts

@@ -0,0 +1,5 @@
+import type { Lang } from '../types/index.js';
+import type { ManagedArtifactRecord } from '../types/index.js';
+import type { ManagedListRow } from '../managed/index.js';
+export declare function renderManagedHistory(record: ManagedArtifactRecord, lang: Lang): string;
+export declare function renderManagedList(rows: ManagedListRow[], lang: Lang): string;