oh-my-knowledge 0.36.0 → 0.38.0

package/dist/cli/commands/eval/index.js

@@ -84,8 +84,11 @@ function batchItemFallbackReport(batch, item) {
     };
 }
 async function loadBatchChildReports(batch, reportsDir, lang) {
-    const { createFileStore } = await import('../../../server/report-store.js');
-    const store = createFileStore(reportsDir);
+    // 读侧走 overlay(本次 reportsDir 优先 → 全局兜底):写默认翻项目后,batch.json 引用的存量 / 全局子报告
+    // 仍能 get 命中,不致降级到 batchItemFallbackReport(来自 batch metadata 的过时数据)。
+    const { createOverlayReportStore } = await import('../../../server/report-store.js');
+    const { globalReportsDir } = await import('../../../eval-core/measurement-dirs.js');
+    const store = createOverlayReportStore(reportsDir, globalReportsDir());
     const reports = [];
     for (const item of batch.items) {
         const loaded = await store.get(item.reportId);
@@ -134,6 +137,8 @@ async function announceSavedReport({ report, filePath, reportsDir, values, lang,
     process.stderr.write(tCli('cli.run.report_saved', lang, { path: filePath }));
     if (!values['no-serve'] && process.stdout.isTTY) {
         const { createReportServer } = await import('../../../server/report-server.js');
+        // eval 结束的即时 serve 刻意钉本次 outputDir(--global 时即全局),不走 overlay:它的语义是「看我刚跑的这份」,
+        // 单目录保证刚写的报告(含 --global 写到全局的)一定可见;浏览全机器历史是 omk studio 的事(默认 overlay 项目优先)。
         const server = createReportServer({ reportsDir });
         const serverUrl = await server.start();
         const reportUrl = `${serverUrl}/reports/${report.id}`;
@@ -368,7 +373,13 @@ export default class Eval extends BaseCommand {
             }),
         }),
         'output-dir': Flags.string({
-            description: bilingual({ zh: '报告输出目录', en: 'Report output dir' }),
+            description: bilingual({ zh: '报告输出目录（默认项目级 .omk/reports）', en: 'Report output dir (default project .omk/reports)' }),
+        }),
+        global: Flags.boolean({
+            description: bilingual({
+                zh: '报告写全局 ~/.oh-my-knowledge/reports，而非项目 .omk/',
+                en: 'Write report to global ~/.oh-my-knowledge/reports instead of project .omk/',
+            }),
         }),
         // ── 评测 toggle ──
         'no-judge': Flags.boolean({

package/dist/cli/commands/evolve.d.ts

@@ -1,6 +1,17 @@
 import { BaseCommand } from '../oclif/base-command.js';
 import { type CliLang } from '../lib/i18n.js';
 import type { EvolveArgs, EvolveFlags } from '../lib/cmd-flags.js';
+/** 路径处是否已存在「用例源」:按 statSync 判型 —— 文件(含无扩展名)直接算存在;
+ *  目录看是否含候选用例文件(排除 report/health/_ 前缀,对齐 sample.ts 的发现约定)。
+ *  用于区分「损坏文件(存在但解析失败 → 报错不覆盖)」与「确实没有用例(可生成)」。
+ *  不能用 extname 猜文件/目录:无扩展名的损坏样本文件会绕过守卫被覆盖,
+ *  带点的目录名(如 samples.v2/)会被误当文件。 */
+export declare function sampleSourceExists(p: string): boolean;
+/** 自动生成时的落盘目标:已存在的目录(含带点目录名,如 samples.v2/)→ 写进目录内的
+ *  samples.json;已存在的文件 → 覆盖该文件;不存在 → 按扩展名(有扩展名当文件,无扩展名
+ *  当目录,落 samples.json)。与 sampleSourceExists 同用 statSync 判型,不被带点目录名
+ *  误当成文件(否则 writeFileSync 撞 EISDIR)。 */
+export declare function resolveSampleOutFile(samplesAbs: string): string;
 export declare function runEvolve(args: EvolveArgs, flags: EvolveFlags, lang: CliLang): Promise<void>;
 export default class Evolve extends BaseCommand {
     static description: string;
@@ -30,6 +41,7 @@ export default class Evolve extends BaseCommand {
         'auto-fix-samples': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'sample-fix-max-attempts': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'reuse-latest-eval': import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'snapshot-only': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'improve-mode': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'holdout-ratio': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'no-significance-gate': import("@oclif/core/interfaces").BooleanFlag<boolean>;

package/dist/cli/commands/evolve.js

@@ -1,5 +1,5 @@
-import { resolve, join } from 'node:path';
-import { existsSync } from 'node:fs';
+import { resolve, join, dirname, extname } from 'node:path';
+import { existsSync, readFileSync, readdirSync, mkdirSync, writeFileSync, statSync } from 'node:fs';
 import { Args, Flags } from '@oclif/core';
 import { LANG_FLAG, bilingual } from '../oclif/i18n.js';
 import { BaseCommand } from '../oclif/base-command.js';
@@ -7,6 +7,17 @@ import { enumStringParser, integerStringParser, numberStringParser } from '../oc
 import { CliExit } from '../lib/cli-exit.js';
 import { tCli } from '../lib/i18n.js';
 import { makeOnProgress } from '../lib/progress.js';
+/** 受管联动旁路:evolve 写回 source 后记证据 + re-baseline。任何异常都不该让 evolve 失败,
+ *  故 try/catch 吞掉、返回 null(同 eval 的 recordEvidenceSafely 口径)。 */
+async function recordEvolveOutcomeSafely(input) {
+    try {
+        const { recordEvolveOutcome } = await import('../lib/record-evolve-outcome.js');
+        return await recordEvolveOutcome(input);
+    }
+    catch {
+        return null;
+    }
+}
 const VALID_EFFORTS = new Set(['low', 'medium', 'high', 'xhigh', 'max']);
 function validateEvolveEffort(raw, lang) {
     if (!VALID_EFFORTS.has(raw)) {
@@ -18,6 +29,40 @@ function validateEvolveEffort(raw, lang) {
     }
     return raw;
 }
+/** 路径处是否已存在「用例源」:按 statSync 判型 —— 文件(含无扩展名)直接算存在;
+ *  目录看是否含候选用例文件(排除 report/health/_ 前缀,对齐 sample.ts 的发现约定)。
+ *  用于区分「损坏文件(存在但解析失败 → 报错不覆盖)」与「确实没有用例(可生成)」。
+ *  不能用 extname 猜文件/目录:无扩展名的损坏样本文件会绕过守卫被覆盖,
+ *  带点的目录名(如 samples.v2/)会被误当文件。 */
+export function sampleSourceExists(p) {
+    let st;
+    try {
+        st = statSync(p);
+    }
+    catch {
+        return false;
+    }
+    if (!st.isDirectory())
+        return true;
+    try {
+        return readdirSync(p).some((f) => /\.(json|ya?ml)$/i.test(f) && !/^(report|health|_)/i.test(f));
+    }
+    catch {
+        return false;
+    }
+}
+/** 自动生成时的落盘目标:已存在的目录(含带点目录名,如 samples.v2/)→ 写进目录内的
+ *  samples.json;已存在的文件 → 覆盖该文件;不存在 → 按扩展名(有扩展名当文件,无扩展名
+ *  当目录,落 samples.json)。与 sampleSourceExists 同用 statSync 判型,不被带点目录名
+ *  误当成文件(否则 writeFileSync 撞 EISDIR)。 */
+export function resolveSampleOutFile(samplesAbs) {
+    try {
+        return statSync(samplesAbs).isDirectory() ? join(samplesAbs, 'samples.json') : samplesAbs;
+    }
+    catch {
+        return extname(samplesAbs) ? samplesAbs : join(samplesAbs, 'samples.json');
+    }
+}
 // runEvolve module-level helper:cli-exit.test 测「skillPath 空 throw CliExit(1)」走
 // in-process import 验证业务,Command.run() body 直接调它。
 export async function runEvolve(args, flags, lang) {
@@ -43,17 +88,86 @@ export async function runEvolve(args, flags, lang) {
         throw new CliExit(1);
     }
     const skillPath = resolvedInput.skillPath;
+    // evolve 目标的形态(目录-skill / 文件-skill),供受管联动按形态精确匹配记录。**取解析后形态**而非「入参是不是
+    // 目录」:帮助文档鼓励传 `skills/foo/SKILL.md`,若按入参判会得 false、匹配不到 install 落的目录记录(漂移永不消)。
+    const skillIsDir = resolvedInput.isDirectorySkill;
     let samplesFile = flags.samples;
     if (samplesFile === 'eval-samples.json' && !existsSync(resolve(samplesFile))) {
         samplesFile = resolvedInput.samplesPath;
     }
-    const { evolveSkill } = await import('../../authoring/evolver.js');
+    // 参数校验必须早于任何昂贵副作用(自动生成用例 / LLM 调用)。
     const { parseJudgeModelsArgOrExit } = await import('../lib/parse-run-config.js');
     const evolveJudges = parseJudgeModelsArgOrExit(flags['judge-models']);
     if (evolveJudges.length > 1) {
         console.error(tCli('cli.common.judge_models_single_only', lang, { cmd: 'omk evolve' }));
         throw new CliExit(2);
     }
+    // 无用例时自动生成 —— 让 omk evolve 成为「检测(doctor) → 生成用例 → 自迭代」一键命令。
+    // 已有用例(且非空)则原样使用;生成失败按普通错误退出。
+    const samplesAbs = resolve(samplesFile);
+    let hasSamples = false;
+    let loadErr = null;
+    try {
+        const { loadSamples } = await import('../../inputs/load-samples.js');
+        hasSamples = loadSamples(samplesAbs).samples.length > 0;
+    }
+    catch (err) {
+        loadErr = err;
+    }
+    const sourceExists = sampleSourceExists(samplesAbs);
+    // 用例源已存在却解析失败(JSON/YAML 语法错、duplicate id 等)= 损坏文件,
+    // 绝不用 LLM 生成内容覆盖它 —— 报错退出,让用户先修。只有真的没有用例源(文件
+    // 不存在 / 目录无候选用例文件)才进入自动生成。
+    if (loadErr && sourceExists) {
+        console.error(lang === 'zh'
+            ? `评测用例文件解析失败，evolve 不会覆盖它，请先修复：${samplesAbs}\n  原因：${loadErr.message}`
+            : `Failed to parse the samples source; evolve will not overwrite it. Fix it first: ${samplesAbs}\n  reason: ${loadErr.message}`);
+        throw new CliExit(1);
+    }
+    if (!hasSamples) {
+        try {
+            const { generateSamples } = await import('../../authoring/generator.js');
+            const skillContent = readFileSync(resolve(skillPath), 'utf-8');
+            // outFile:已存在目录写进内部 samples.json,已存在文件覆盖,不存在按扩展名 —— statSync
+            // 判型,不被带点目录名(samples.v2/)骗。loadSamples 目录模式会自动发现生成的文件。
+            const outFile = resolveSampleOutFile(samplesAbs);
+            // sourceExists 为真 = 用例源存在但解析出 0 条(合法空 [])→ 明示"重新生成覆盖空文件",
+            // 不静默盖用户文件;为假 = 真没有用例源 → "未发现，生成"。
+            process.stderr.write(lang === 'zh'
+                ? (sourceExists
+                    ? `评测用例为空，正在重新生成并覆盖 ${outFile} …\n`
+                    : `未发现评测用例，正在自动生成到 ${outFile} …\n`)
+                : (sourceExists
+                    ? `Samples are empty; regenerating (overwriting) ${outFile} …\n`
+                    : `No samples found; auto-generating to ${outFile} …\n`));
+            const { samples, costUSD } = await generateSamples({
+                skillContent,
+                model: flags.model,
+                executorName: flags.executor,
+            });
+            // 模型可能保守返回 0 条 —— 不写空文件再空跑迭代,直接报错让用户改用
+            // `omk sample --focus` 引导生成或手写用例。
+            if (samples.length === 0) {
+                console.error(lang === 'zh'
+                    ? '自动生成返回 0 条用例，已中止。请用 `omk sample <skill> --focus "…"` 引导生成，或手写后重试。'
+                    : 'Auto-generation produced 0 samples; aborting. Use `omk sample <skill> --focus "…"` to guide generation, or write samples manually.');
+                throw new CliExit(1);
+            }
+            mkdirSync(dirname(outFile), { recursive: true });
+            writeFileSync(outFile, JSON.stringify(samples, null, 2));
+            const cost = costUSD > 0 ? ` $${costUSD.toFixed(4)}` : '';
+            process.stderr.write(lang === 'zh'
+                ? `已生成 ${samples.length} 条用例${cost}，开始自迭代。\n`
+                : `Generated ${samples.length} samples${cost}; starting evolution.\n`);
+        }
+        catch (err) {
+            if (err instanceof CliExit)
+                throw err;
+            console.error(tCli('cli.common.error_prefix', lang, { message: err.message }));
+            throw new CliExit(1);
+        }
+    }
+    const { evolveSkill } = await import('../../authoring/evolver.js');
     process.stderr.write(tCli('cli.evolve.section_header', lang, { path: skillPath }));
     try {
         const result = await evolveSkill({
@@ -83,6 +197,8 @@ export async function runEvolve(args, flags, lang) {
             testRatio: Number(flags['test-ratio']),
             editBudget: flags['no-edit-budget'] ? 0 : Number(flags['edit-budget']),
             rejectMemory: !flags['no-reject-memory'],
+            // --snapshot-only:不写回 source,候选只留在 evolve/<skillName>.r{N}.md(供人工挑选 / promote)。
+            writeBackToSource: !flags['snapshot-only'],
             improveMode: flags['improve-mode'] === 'rewrite' ? 'rewrite' : 'agent',
             onProgress: makeOnProgress(lang),
             onRoundProgress({ round, totalRounds: _totalRounds, phase, score, delta, accepted, costUSD, costReported, error, significant }) {
@@ -146,6 +262,28 @@ export async function runEvolve(args, flags, lang) {
         if (result.reportId) {
             process.stderr.write(tCli('cli.evolve.report_link', lang, { id: result.reportId }));
         }
+        if (flags['snapshot-only']) {
+            // 不写回 source —— 候选留在 evolve/ 供人工挑选;受管记录不动。
+            process.stderr.write(tCli('cli.evolve.snapshot_only_hint', lang, {
+                dir: join(resolve(skillPath, '..'), 'evolve'),
+            }));
+        }
+        else {
+            // 受管 skill:把胜出版本记成带 verdict 的证据 + re-baseline → omk list 显 measurable。
+            // 升 promoted 仍由人 omk promote 决定(统计门 ≠ 人的接受)。未纳管 / 无改进 → 静默 no-op。
+            const recorded = await recordEvolveOutcomeSafely({
+                reportId: result.reportId,
+                bestRound: result.bestRound,
+                skillPath: resolvedInput.skillPath,
+                skillDir: resolvedInput.skillDir,
+                isDirectorySkill: skillIsDir,
+            });
+            if (recorded) {
+                process.stderr.write(tCli('cli.evolve.evidence_recorded_managed', lang, {
+                    name: recorded.name, verdict: recorded.verdict,
+                }));
+            }
+        }
         console.log(JSON.stringify(result, null, 2));
     }
     catch (err) {
@@ -208,8 +346,8 @@ export default class Evolve extends BaseCommand {
         }),
         model: Flags.string({
             description: bilingual({
-                zh: '被评测的 LLM，默认 sonnet',
-                en: 'Evaluated LLM, default sonnet',
+                zh: '被评测的 LLM，默认 sonnet。无用例时也用作自动生成用例的出题模型。',
+                en: 'Evaluated LLM, default sonnet. Also used as the sample-generation model when no samples exist.',
             }),
             default: 'sonnet',
         }),
@@ -298,6 +436,13 @@ export default class Evolve extends BaseCommand {
             }),
             default: false,
         }),
+        'snapshot-only': Flags.boolean({
+            description: bilingual({
+                zh: '只产候选、不写回 source：胜出版本留在 evolve/<skillName>.r{N}.md 供你挑选，再 omk promote 接受。受管 skill 默认会写回 source 并记证据（measurable）。',
+                en: 'Produce candidates only, do not write back to source: the winner stays in evolve/<skillName>.r{N}.md for you to pick and then omk promote. By default a managed skill is written back and evidence is recorded (measurable).',
+            }),
+            default: false,
+        }),
         'improve-mode': Flags.string({
             description: bilingual({
                 zh: '改写策略（默认：agent）',

package/dist/cli/commands/init.js

@@ -3,6 +3,15 @@ import { Args } from '@oclif/core';
 import { LANG_FLAG, bilingual, resolveLang } from '../oclif/i18n.js';
 import { BaseCommand } from '../oclif/base-command.js';
 import { tCli } from '../lib/i18n.js';
+// 预置 .omk/.gitignore:测量 bulk + doctor --fix 备份(项目本地、不该入库)默认不入库;
+// managed/ 治理档案 + 配置不在此列,默认 track。
+const INIT_OMK_GITIGNORE = `# omk 测量 bulk + doctor --fix 备份(项目本地)——不入库;前导 / 锚定 .omk/ 顶层,不误伤嵌套同名目录。
+/observe-health/
+/doctors/
+/observe-inbox/
+/reports/
+/backups/
+`;
 const INIT_SAMPLES = `[
   {
     "sample_id": "s001",
@@ -83,21 +92,21 @@ description: 多维度代码审查,覆盖安全 / 健壮 / 可维护 / 性能,
 `;
 export default class Init extends BaseCommand {
     static description = bilingual({
-        zh: '初始化 omk 项目脚手架（skills/ + eval-samples.json 模板）。',
-        en: 'Scaffold an omk project (skills/ + eval-samples.json templates).',
+        zh: '初始化一个 omk 项目：在目标目录铺好待测知识载体（skills/）与评测用例（eval-samples.json），供 omk eval / doctor / evolve / observe / list 操作。默认是两版 code-review skill 的 A/B 起步模板。',
+        en: 'Initialize an omk project: scaffold knowledge artifacts (skills/) and eval samples (eval-samples.json) in the target dir for omk eval / doctor / evolve / observe / list to work on. Ships a two-variant code-review A/B starter template by default.',
     });
     static examples = [
         {
             description: bilingual({
-                zh: '在当前目录初始化',
-                en: 'Init in current directory',
+                zh: '在当前目录初始化一个 omk 项目',
+                en: 'Initialize an omk project in the current directory',
             }),
             command: '<%= config.bin %> init',
         },
         {
             description: bilingual({
-                zh: '在指定目录初始化',
-                en: 'Init in specified directory',
+                zh: '在指定目录初始化一个 omk 项目',
+                en: 'Initialize an omk project in a specified directory',
             }),
             command: '<%= config.bin %> init my-project',
         },
@@ -139,6 +148,9 @@ export default class Init extends BaseCommand {
             writeFileSync(join(targetDir, 'eval-samples.json'), INIT_SAMPLES);
             writeFileSync(join(targetDir, 'skills', 'code-review-v1', 'SKILL.md'), INIT_SKILL_V1);
             writeFileSync(join(targetDir, 'skills', 'code-review-v2', 'SKILL.md'), INIT_SKILL_V2);
+            // 像 dvc init 那样预置忽略规则,开发者不会误把测量 bulk 提交进库。
+            mkdirSync(join(targetDir, '.omk'), { recursive: true });
+            writeFileSync(join(targetDir, '.omk', '.gitignore'), INIT_OMK_GITIGNORE);
             console.log(tCli('cli.init.scaffolded', lang, { dir: targetDir }));
             console.log('');
             console.log(tCli('cli.init.next_steps_title', lang));

package/dist/cli/commands/list.d.ts

@@ -1,35 +1,12 @@
 import { BaseCommand } from '../oclif/base-command.js';
-import { type ManagedListRow, type SourceProbe } from '../../managed/index.js';
-import type { ManagedArtifactRecord } from '../../types/index.js';
+import { sanitizeCell } from '../lib/cell-format.js';
+import { type ManagedListRow } from '../../managed/index.js';
 import type { CliLang } from '../lib/i18n.js';
-/**
- * 探测一条受管记录**当前源**的状态(三态,喂 buildManagedListRow 判 drift / 生命周期)。
- *   - 远端 git(带 url):源身份钉不可变 SHA(install 时 pin),内容恒定 → 直接取 record.contentHash,
- *     不联网(list 是快读命令,不为 drift 检查发网络请求)。reachable。
- *   - 本地 git:locator `git:<ref>:<spec>` 复用 resolveInstallSource 在**仓库对象库**内重物化重哈
- *     (读取受 git 边界约束,无任意文件读 DoS)。解析不到(常因 `omk list` 的 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;
 /** CJK 全角字符按 2 列计宽,使含中文表头的列也能对齐。 */
 export declare function dispWidth(s: string): number;
 /** 按**显示宽度**截断(不是 code unit):逐码点累加 dispWidth,绝不切断 surrogate 对、CJK 也不溢出列。 */
 export declare function truncate(s: string, max: number): string;
-/** 洗不可信显示字符:managed JSON 可随仓库分发,name / sourceLabel / verdict 等字段塞进表格前必须先洗,
- *  否则会破坏表格甚至伪造终端输出。一律映射到可见 U+FFFD(--json 路径保留原值给脚本)。
- *  用 Unicode **属性类**而非手列码点 —— 手列清单天然有缺口(BiDi、U+2028 / 2029、Tags 块都曾漏一轮补一轮),
- *  属性类一次覆盖整类、新码点自动纳入:
- *    - `\p{Cc}` 控制符(C0 / C1 / DEL,含 ESC / 换行 / 回车 / TAB)→ 杀 ANSI / OSC 转义与终端控制;
- *    - `\p{Cf}` 格式符(BiDi 重排 / 隔离、零宽、joiners、BOM、Tags、interlinear)→ 防 Trojan-Source 视觉伪造与零宽隐藏 / 分割;
- *    - `\p{Zl}` / `\p{Zp}` 行 / 段分隔(U+2028 / 2029)→ LF 的 Unicode 孪生,防换行伪造表格行;
- *    - `\p{Mn}` / `\p{Me}` 非间距 / 封闭组合附加符 → 变可见,避免零前进宽度令 dispWidth 与终端列错位
- *      (间距组合符 `\p{Mc}` 合法占 1 列,保留);
- *    - Hangul filler(U+115F / U+1160 / U+3164,属 Lo 不在上述任何类)→ 零宽显示诡计,补列。 */
-export declare function sanitizeCell(s: string): string;
+export { sanitizeCell };
 export declare function renderTable(rows: ManagedListRow[], lang: CliLang): string;
 export default class List extends BaseCommand {
     static description: string;

package/dist/cli/commands/list.js

@@ -1,131 +1,9 @@
-import { existsSync, lstatSync, readdirSync } from 'node:fs';
-import { isAbsolute, join, resolve } from 'node:path';
 import { Flags } from '@oclif/core';
 import { LANG_FLAG, bilingual } from '../oclif/i18n.js';
 import { BaseCommand } from '../oclif/base-command.js';
 import { tCli } from '../lib/i18n.js';
-import { resolveInstallSource } from '../../inputs/source-resolver.js';
-import { buildManagedListRows, globalManagedDir, hashArtifactSource, isDistributablePath, loadAllManagedRecords, managedDir, resolveManagedDir, } from '../../managed/index.js';
-// 本地源读取成本上限。skill 是小体量 markdown(+少量 references 资产),远超这些边界的源必是手改 /
-// 投毒,拒读避免 `omk list`(只读命令,读盘上可能随仓库分发的 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 可指向任意可读目录让 list 递归读整棵树),再 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,
- *     不联网(list 是快读命令,不为 drift 检查发网络请求)。reachable。
- *   - 本地 git:locator `git:<ref>:<spec>` 复用 resolveInstallSource 在**仓库对象库**内重物化重哈
- *     (读取受 git 边界约束,无任意文件读 DoS)。解析不到(常因 `omk list` 的 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 };
-    }
-}
+import { sanitizeCell } from '../lib/cell-format.js';
+import { globalManagedDir, listManagedRows, managedDir, resolveManagedDir, } from '../../managed/index.js';
 /** CJK 全角字符按 2 列计宽,使含中文表头的列也能对齐。 */
 export function dispWidth(s) {
     let w = 0;
@@ -151,19 +29,9 @@ export function truncate(s, max) {
     }
     return `${out}…`;
 }
-/** 洗不可信显示字符:managed JSON 可随仓库分发,name / sourceLabel / verdict 等字段塞进表格前必须先洗,
- *  否则会破坏表格甚至伪造终端输出。一律映射到可见 U+FFFD(--json 路径保留原值给脚本)。
- *  用 Unicode **属性类**而非手列码点 —— 手列清单天然有缺口(BiDi、U+2028 / 2029、Tags 块都曾漏一轮补一轮),
- *  属性类一次覆盖整类、新码点自动纳入:
- *    - `\p{Cc}` 控制符(C0 / C1 / DEL,含 ESC / 换行 / 回车 / TAB)→ 杀 ANSI / OSC 转义与终端控制;
- *    - `\p{Cf}` 格式符(BiDi 重排 / 隔离、零宽、joiners、BOM、Tags、interlinear)→ 防 Trojan-Source 视觉伪造与零宽隐藏 / 分割;
- *    - `\p{Zl}` / `\p{Zp}` 行 / 段分隔(U+2028 / 2029)→ LF 的 Unicode 孪生,防换行伪造表格行;
- *    - `\p{Mn}` / `\p{Me}` 非间距 / 封闭组合附加符 → 变可见,避免零前进宽度令 dispWidth 与终端列错位
- *      (间距组合符 `\p{Mc}` 合法占 1 列,保留);
- *    - Hangul filler(U+115F / U+1160 / U+3164,属 Lo 不在上述任何类)→ 零宽显示诡计,补列。 */
-export function sanitizeCell(s) {
-    return s.replace(/[\p{Cc}\p{Cf}\p{Zl}\p{Zp}\p{Mn}\p{Me}ᅟᅠㅤ]/gu, '�');
-}
+// sanitizeCell 已下沉到 ../lib/cell-format.js(promote 文本输出复用同一套不可信字符洗白)。
+// 此处 re-export 保持既有 import 入口不破(test/cli/list-probe.test.ts 仍从本文件取 sanitizeCell)。
+export { sanitizeCell };
 export function renderTable(rows, lang) {
     const headers = [
         tCli('cli.list.col_name', lang),
@@ -176,8 +44,8 @@ export function renderTable(rows, lang) {
     const cells = rows.map((r) => [
         truncate(sanitizeCell(r.name), 40), // name 与 source 同为用户可控、可超长 → 同样按显示宽度截断,防撑爆表宽
         r.kind, // ArtifactKind 枚举(validator 已收窄),无需洗
-        // 不可达 → 标「?」(drift 未核),绝不冒充 stale;reachable 且漂移才 stale ⚠️。
-        !r.reachable ? `${r.state} ?` : r.state === 'stale' ? 'stale ⚠️' : r.state,
+        // 不可达 → 标「?」(drift 未核),绝不冒充 stale;reachable 且漂移才 stale ⚠️;已人工接受标 promoted ✓。
+        !r.reachable ? `${r.state} ?` : r.state === 'stale' ? 'stale ⚠️' : r.state === 'promoted' ? 'promoted ✓' : r.state,
         r.latestVerdict ? sanitizeCell(r.latestVerdict) : '—',
         `${r.currentEvidenceCount}/${r.totalEvidenceCount}`,
         truncate(sanitizeCell(r.sourceLabel), 48),
@@ -188,8 +56,8 @@ export function renderTable(rows, lang) {
 }
 export default class List extends BaseCommand {
     static description = bilingual({
-        zh: '列出受管 skill 及其证据状态：生命周期（installed / measurable / stale）、最新 verdict、证据数、源。',
-        en: 'List managed skills with evidence status: lifecycle (installed / measurable / stale), latest verdict, evidence count, source.',
+        zh: '列出受管 skill 及其证据状态：生命周期（installed / measurable / promoted / stale）、最新 verdict、证据数、源。',
+        en: 'List managed skills with evidence status: lifecycle (installed / measurable / promoted / stale), latest verdict, evidence count, source.',
     });
     static examples = [
         { description: bilingual({ zh: '列出当前项目的受管 skill', en: 'List managed skills in the current project' }), command: '<%= config.bin %> list' },
@@ -210,8 +78,7 @@ export default class List extends BaseCommand {
         const lang = this.lang;
         await this.runWithCliExit(async () => {
             const dir = flags.global ? globalManagedDir() : resolveManagedDir(managedDir());
-            const records = loadAllManagedRecords(dir);
-            const rows = buildManagedListRows(records, probeSourceState);
+            const rows = listManagedRows(dir);
             if (flags.json) {
                 // 版本化信封 —— 与 eval / doctor / diagnosis 等机读出口一致(都带 schemaVersion),让未来字段增删 /
                 // 改名是可检测的版本 bump,而非脚本静默 break。rows 的逐行形态见 ManagedListRow。
@@ -231,8 +98,11 @@ export default class List extends BaseCommand {
             // 注脚块前留一行空白(无论先触发哪条 note);空行挂在块上而非 drift 分支,避免只 unreachable 时丢分隔。
             const hasDrift = rows.some((r) => r.drifted);
             const hasUnreachable = rows.some((r) => !r.reachable);
-            if (hasDrift || hasUnreachable)
+            const hasPromoted = rows.some((r) => r.state === 'promoted');
+            if (hasDrift || hasUnreachable || hasPromoted)
                 process.stderr.write('\n');
+            if (hasPromoted)
+                process.stderr.write(tCli('cli.list.promoted_note', lang));
             if (hasDrift)
                 process.stderr.write(tCli('cli.list.drift_note', lang));
             if (hasUnreachable)

package/dist/cli/commands/observe/inbox.d.ts

@@ -7,6 +7,7 @@ export default class ObserveInbox extends BaseCommand {
     static flags: {
         lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'input-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         skill: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         limit: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         explore: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;

package/dist/cli/commands/observe/inbox.js

@@ -20,8 +20,11 @@ function pickSkillToolCounts(value, skillName) {
 }
 // runObserveInbox export:test/cli/observe.test.ts in-process import 验证 by-skill 聚合行为。
 export async function runObserveInbox(_args, flags, lang) {
-    const { queryObservationInbox, selectExploreInboxItems, loadLatestObservationInboxReports, summarizeObservationInboxBySkill, DEFAULT_OBSERVATIONS_DIR } = await import('../../../observability/inbox.js');
-    const dir = resolve(flags['input-dir'] || DEFAULT_OBSERVATIONS_DIR);
+    const { queryObservationInbox, selectExploreInboxItems, loadLatestObservationInboxReports, summarizeObservationInboxBySkill, DEFAULT_OBSERVATIONS_DIR, DEFAULT_GLOBAL_OBSERVATIONS_DIR } = await import('../../../observability/inbox.js');
+    // 显式 --input-dir 最高;否则 --global 直读全局、默认读项目(空则 loadObservationInboxReports 兜底全局)。
+    const dir = flags['input-dir']
+        ? resolve(flags['input-dir'])
+        : (flags.global ? DEFAULT_GLOBAL_OBSERVATIONS_DIR : DEFAULT_OBSERVATIONS_DIR);
     if (flags['llm-enhanced-review']) {
         const { buildObservationInboxViewModel } = await import('../../../observability/inbox-view-model.js');
         const { extractSkillSoftStandards, DEFAULT_LLM_ENHANCED_REVIEW_MODEL } = await import('../../../observability/soft-standards/index.js');
@@ -186,10 +189,17 @@ export default class ObserveInbox extends BaseCommand {
         lang: LANG_FLAG,
         'input-dir': Flags.string({
             description: bilingual({
-                zh: 'inbox 数据目录，默认 .omk/observations（项目级，相对于 cwd）；目录不存在时兜底读 ~/.oh-my-knowledge/observations。',
-                en: 'Inbox data dir, default .omk/observations (project-local); falls back to ~/.oh-my-knowledge/observations when missing.',
+                zh: 'inbox 数据目录，默认 .omk/observe-inbox（项目级，相对于 cwd）；目录不存在时兜底读 ~/.oh-my-knowledge/observe-inbox。',
+                en: 'Inbox data dir, default .omk/observe-inbox (project-local); falls back to ~/.oh-my-knowledge/observe-inbox when missing.',
             }),
         }),
+        global: Flags.boolean({
+            description: bilingual({
+                zh: '直接读取全局 ~/.oh-my-knowledge/observe-inbox（跳过项目级与兜底）。',
+                en: 'Read directly from global ~/.oh-my-knowledge/observe-inbox (skip project-local and fallback).',
+            }),
+            default: false,
+        }),
         skill: Flags.string({
             description: bilingual({ zh: '只看指定 skill', en: 'Filter to specific skill' }),
         }),