oh-my-knowledge 0.30.0 → 0.32.0

package/dist/cli/lib/i18n-dict.d.ts

@@ -0,0 +1,63 @@
+/**
+ * CLI 文案字典 barrel。
+ *
+ * 命名约定: `cli.<command>.<event>` 或 `cli.common.<event>`。
+ * 占位符用 `{name}` 形式,在 tCli(params) 处替换。
+ *
+ * 各子文件按 command/domain 分组(init / run / gen / evolve / help / common),
+ * 本文件只做类型 union 与 dict 合并,不直接持有条目。新增文案请编辑对应子文件,
+ * 并把新 key 追加到该子文件的 `*MessageKey` union。
+ *
+ * ============================================================================
+ * 翻译守则 (受 cc-viewer i18n 方案启发)
+ * ============================================================================
+ *
+ * 1. **彻底本地化, 不接受中英混搭**
+ *    "中文用户读到的中文"和"英文用户读到的英文"必须是各自语言里自然的表达,
+ *    不能机械翻译, 不能在中文里塞英文短语解释术语。如果某个英文短语没有
+ *    自然的中文译法, 重新组织句子结构, 而不是混着写。
+ *
+ * 2. **保留原文的白名单 (产品术语 / 命令 / 文件名)**
+ *    以下 token 在两种语言里都保留原文, 不翻译:
+ *    - 产品名: omk, oh-my-knowledge, Claude, npm
+ *    - 命令名: init, doctor, eval, observe, evolve, sample, studio, gold
+ *    - omk 核心业务术语: skill, variant, sample, judge, executor (出现在产品
+ *      UI 里时首字母可大写如 "Skill 评测", 描述句中保持小写)
+ *    - 技术参数: --lang, --control, --treatment, --bootstrap, --judge-repeat,
+ *      OMK_LANG, JUDGE_PROMPT_VERSION_*
+ *    - 文件名 / 路径: eval-samples.json, skills/v1.md, ~/.oh-my-knowledge/...
+ *    - 数学概念缩写: CI, α, RAG (其译法可在配套描述里说明, 但术语本身留原文)
+ *
+ * 3. **必须翻译的内容**
+ *    动作 (run / edit / scaffold / generate), 状态 (success / failed /
+ *    invalid), 引导文案 (next steps / try this / see also), 解释性描述。
+ *
+ * 4. **不要机械直译**
+ *    "Next steps:" 译 "下一步:" 而不是 "下一步骤:"。
+ *    "Run: ..." 译 "运行: ..." 而不是 "跑: ..."。
+ *    选用 omk 项目长期使用的中文措辞 (LLM judge 译"评委" 不译"判官", 见
+ *    feedback_ui_translation.md)。
+ *
+ * 5. **新增 key 流程**
+ *    a. 选定对应子文件 (init / run / gen / evolve / help / common)
+ *    b. 在子文件的 `*MessageKey` union 里加新 key
+ *    c. 在子文件的 dict 里同时给出 zh / en (Record 类型强制 zh/en 双写, 漏写
+ *       tsc 直接报错)
+ *    d. 自查: 中文里有没有非白名单的英文? 英文里有没有中文?
+ *    e. 自查: 措辞自然度 — 把中文版念出来, 像不像中文项目的命令行输出?
+ *    f. test/cli-i18n.test.ts 会跑 runtime parity 检查
+ *
+ * 未来扩 Lang (zh-TW / ja / ko ...): 改 src/types/shared.ts 的 Lang union,
+ * Record 类型自动强制每 key 加新语言版本。
+ */
+import { type CommonMessageKey } from './i18n-dict/common.js';
+import { type EvolveMessageKey } from './i18n-dict/evolve.js';
+import { type GenMessageKey } from './i18n-dict/gen.js';
+import { type HelpMessageKey } from './i18n-dict/help.js';
+import { type InitMessageKey } from './i18n-dict/init.js';
+import { type RunMessageKey } from './i18n-dict/run.js';
+import type { CliMessage } from './i18n-dict/types.js';
+export type { CliMessage } from './i18n-dict/types.js';
+export type CliMessageKey = CommonMessageKey | EvolveMessageKey | GenMessageKey | HelpMessageKey | InitMessageKey | RunMessageKey;
+export declare const CLI_DICT: Record<CliMessageKey, CliMessage>;
+//# sourceMappingURL=i18n-dict.d.ts.map

package/dist/cli/lib/i18n-dict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-dict.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/i18n-dict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAY,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAW,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,YAAY,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAEvD,MAAM,MAAM,aAAa,GACrB,gBAAgB,GAChB,gBAAgB,GAChB,aAAa,GACb,cAAc,GACd,cAAc,GACd,aAAa,CAAC;AAElB,eAAO,MAAM,QAAQ,EAAE,MAAM,CAAC,aAAa,EAAE,UAAU,CAOtD,CAAC"}

package/dist/cli/lib/i18n-dict.js

@@ -0,0 +1,67 @@
+/**
+ * CLI 文案字典 barrel。
+ *
+ * 命名约定: `cli.<command>.<event>` 或 `cli.common.<event>`。
+ * 占位符用 `{name}` 形式,在 tCli(params) 处替换。
+ *
+ * 各子文件按 command/domain 分组(init / run / gen / evolve / help / common),
+ * 本文件只做类型 union 与 dict 合并,不直接持有条目。新增文案请编辑对应子文件,
+ * 并把新 key 追加到该子文件的 `*MessageKey` union。
+ *
+ * ============================================================================
+ * 翻译守则 (受 cc-viewer i18n 方案启发)
+ * ============================================================================
+ *
+ * 1. **彻底本地化, 不接受中英混搭**
+ *    "中文用户读到的中文"和"英文用户读到的英文"必须是各自语言里自然的表达,
+ *    不能机械翻译, 不能在中文里塞英文短语解释术语。如果某个英文短语没有
+ *    自然的中文译法, 重新组织句子结构, 而不是混着写。
+ *
+ * 2. **保留原文的白名单 (产品术语 / 命令 / 文件名)**
+ *    以下 token 在两种语言里都保留原文, 不翻译:
+ *    - 产品名: omk, oh-my-knowledge, Claude, npm
+ *    - 命令名: init, doctor, eval, observe, evolve, sample, studio, gold
+ *    - omk 核心业务术语: skill, variant, sample, judge, executor (出现在产品
+ *      UI 里时首字母可大写如 "Skill 评测", 描述句中保持小写)
+ *    - 技术参数: --lang, --control, --treatment, --bootstrap, --judge-repeat,
+ *      OMK_LANG, JUDGE_PROMPT_VERSION_*
+ *    - 文件名 / 路径: eval-samples.json, skills/v1.md, ~/.oh-my-knowledge/...
+ *    - 数学概念缩写: CI, α, RAG (其译法可在配套描述里说明, 但术语本身留原文)
+ *
+ * 3. **必须翻译的内容**
+ *    动作 (run / edit / scaffold / generate), 状态 (success / failed /
+ *    invalid), 引导文案 (next steps / try this / see also), 解释性描述。
+ *
+ * 4. **不要机械直译**
+ *    "Next steps:" 译 "下一步:" 而不是 "下一步骤:"。
+ *    "Run: ..." 译 "运行: ..." 而不是 "跑: ..."。
+ *    选用 omk 项目长期使用的中文措辞 (LLM judge 译"评委" 不译"判官", 见
+ *    feedback_ui_translation.md)。
+ *
+ * 5. **新增 key 流程**
+ *    a. 选定对应子文件 (init / run / gen / evolve / help / common)
+ *    b. 在子文件的 `*MessageKey` union 里加新 key
+ *    c. 在子文件的 dict 里同时给出 zh / en (Record 类型强制 zh/en 双写, 漏写
+ *       tsc 直接报错)
+ *    d. 自查: 中文里有没有非白名单的英文? 英文里有没有中文?
+ *    e. 自查: 措辞自然度 — 把中文版念出来, 像不像中文项目的命令行输出?
+ *    f. test/cli-i18n.test.ts 会跑 runtime parity 检查
+ *
+ * 未来扩 Lang (zh-TW / ja / ko ...): 改 src/types/shared.ts 的 Lang union,
+ * Record 类型自动强制每 key 加新语言版本。
+ */
+import { commonDict } from './i18n-dict/common.js';
+import { evolveDict } from './i18n-dict/evolve.js';
+import { genDict } from './i18n-dict/gen.js';
+import { helpDict } from './i18n-dict/help.js';
+import { initDict } from './i18n-dict/init.js';
+import { runDict } from './i18n-dict/run.js';
+export const CLI_DICT = {
+    ...commonDict,
+    ...evolveDict,
+    ...genDict,
+    ...helpDict,
+    ...initDict,
+    ...runDict,
+};
+//# sourceMappingURL=i18n-dict.js.map

package/dist/cli/lib/i18n-dict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n-dict.js","sourceRoot":"","sources":["../../../src/cli/lib/i18n-dict.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AAEH,OAAO,EAAE,UAAU,EAAyB,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAyB,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AACjE,OAAO,EAAE,QAAQ,EAAuB,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,QAAQ,EAAuB,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AAajE,MAAM,CAAC,MAAM,QAAQ,GAAsC;IACzD,GAAG,UAAU;IACb,GAAG,UAAU;IACb,GAAG,OAAO;IACV,GAAG,QAAQ;IACX,GAAG,QAAQ;IACX,GAAG,OAAO;CACX,CAAC"}

package/dist/cli/lib/i18n.d.ts

@@ -0,0 +1,29 @@
+import type { Lang } from '../../types/shared.js';
+import { type CliMessageKey } from './i18n-dict.js';
+export type CliLang = Lang;
+/**
+ * main() 在子命令 parseArgs 之前就需要拿到 lang(用于打印 unknown 提示)。
+ * 早期 scan argv,支持 `--lang en` 和 `--lang=en` 两种形式。
+ */
+export declare function parseLangFromArgv(argv: readonly string[]): string | undefined;
+/**
+ * 优先级: --lang flag > OMK_LANG env > 默认 zh。
+ * 不识别的值静默退回默认,避免在解析阶段抛错让用户卡住。
+ */
+export declare function getCliLang(flagValue?: string): CliLang;
+/**
+ * 缺 key 时返回 key 本身,便于在 dev / CI 中肉眼/脚本发现遗漏。
+ * params 用 {name} 占位符做 string 替换。
+ */
+export declare function tCli(key: CliMessageKey, lang?: CliLang, params?: Record<string, string | number>): string;
+/**
+ * 一次拿到 i18n key 的 zh / en 两个串。oclif Command 的 static
+ * description / examples 是模块加载期 evaluate 的字面量,跑不到 tCli 的 runtime
+ * lang dispatch。tBoth 返回 {zh, en} 结构,配合 oclif/i18n.ts 的 bilingual()
+ * 拼成带 sentinel 的串,LangAwareHelp 渲染时按 lang 切。
+ */
+export declare function tBoth(key: CliMessageKey, params?: Record<string, string | number>): {
+    zh: string;
+    en: string;
+};
+//# sourceMappingURL=i18n.d.ts.map

package/dist/cli/lib/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE9D,MAAM,MAAM,OAAO,GAAG,IAAI,CAAC;AAK3B;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAO7E;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAMtD;AAED;;;GAGG;AACH,wBAAgB,IAAI,CAClB,GAAG,EAAE,aAAa,EAClB,IAAI,GAAE,OAAsB,EAC5B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACvC,MAAM,CAUR;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CACnB,GAAG,EAAE,aAAa,EAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACvC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAK5B"}

package/dist/cli/lib/i18n.js

@@ -0,0 +1,58 @@
+import { CLI_DICT } from './i18n-dict.js';
+const DEFAULT_LANG = 'zh';
+const SUPPORTED = new Set(['zh', 'en']);
+/**
+ * main() 在子命令 parseArgs 之前就需要拿到 lang(用于打印 unknown 提示)。
+ * 早期 scan argv,支持 `--lang en` 和 `--lang=en` 两种形式。
+ */
+export function parseLangFromArgv(argv) {
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === '--lang' && i + 1 < argv.length)
+            return argv[i + 1];
+        if (a && a.startsWith('--lang='))
+            return a.slice('--lang='.length);
+    }
+    return undefined;
+}
+/**
+ * 优先级: --lang flag > OMK_LANG env > 默认 zh。
+ * 不识别的值静默退回默认,避免在解析阶段抛错让用户卡住。
+ */
+export function getCliLang(flagValue) {
+    const candidates = [flagValue, process.env.OMK_LANG];
+    for (const c of candidates) {
+        if (c && SUPPORTED.has(c))
+            return c;
+    }
+    return DEFAULT_LANG;
+}
+/**
+ * 缺 key 时返回 key 本身,便于在 dev / CI 中肉眼/脚本发现遗漏。
+ * params 用 {name} 占位符做 string 替换。
+ */
+export function tCli(key, lang = DEFAULT_LANG, params) {
+    const entry = CLI_DICT[key];
+    if (!entry)
+        return key;
+    let text = entry[lang] ?? entry[DEFAULT_LANG] ?? key;
+    if (params) {
+        for (const [k, v] of Object.entries(params)) {
+            text = text.replaceAll(`{${k}}`, String(v));
+        }
+    }
+    return text;
+}
+/**
+ * 一次拿到 i18n key 的 zh / en 两个串。oclif Command 的 static
+ * description / examples 是模块加载期 evaluate 的字面量,跑不到 tCli 的 runtime
+ * lang dispatch。tBoth 返回 {zh, en} 结构,配合 oclif/i18n.ts 的 bilingual()
+ * 拼成带 sentinel 的串,LangAwareHelp 渲染时按 lang 切。
+ */
+export function tBoth(key, params) {
+    return {
+        zh: tCli(key, 'zh', params),
+        en: tCli(key, 'en', params),
+    };
+}
+//# sourceMappingURL=i18n.js.map

package/dist/cli/lib/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../../src/cli/lib/i18n.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAsB,MAAM,gBAAgB,CAAC;AAI9D,MAAM,YAAY,GAAY,IAAI,CAAC;AACnC,MAAM,SAAS,GAAwB,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAE7D;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAuB;IACvD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9D,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,SAAkB;IAC3C,MAAM,UAAU,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACrD,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;YAAE,OAAO,CAAY,CAAC;IACjD,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,IAAI,CAClB,GAAkB,EAClB,OAAgB,YAAY,EAC5B,MAAwC;IAExC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,CAAC;IACvB,IAAI,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC;IACrD,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAC5C,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CACnB,GAAkB,EAClB,MAAwC;IAExC,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC;QAC3B,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/cli/lib/parse-run-config/judge-models.d.ts

@@ -0,0 +1,24 @@
+/**
+ * `--judge-models` CLI 参数解析。
+ *
+ * 输入格式: `executor:model[,executor:model,...]`
+ *   - 1 entry = 单评委
+ *   - ≥ 2 entry = ensemble(是否接受由调用方决定)
+ *
+ * 校验语义:
+ *   - 空字符串 / 全空 entry 抛错(避免 silent default)
+ *   - entry 必须是 `executor:model`,缺一报错
+ *   - 重复 `executor:model` 拒绝 —— ensemble 聚合用 `Map<judgeId, scores>` 会把
+ *     同 id 合并,N 不可信、agreement 失真;而 grading 阶段又会按 entry 数实际跑
+ *     N 次,产生「跑了但聚合不到」的隐藏成本
+ *
+ * 两个公开符号:
+ *   - `parseJudgeModelsArg`: 纯函数,throw Error,供单测断言文案
+ *   - `parseJudgeModelsArgOrExit`: CLI 友好封装,catch 后 stderr + CliExit(2),
+ *     给 `eval` / `evolve` 子命令共用(exit 2 = parser/参数错误,区别于
+ *     doctor / gate eval failure 的 exit 1)
+ */
+import type { JudgeConfig } from '../../../types/index.js';
+export declare function parseJudgeModelsArg(raw: string): JudgeConfig[];
+export declare function parseJudgeModelsArgOrExit(raw: string): JudgeConfig[];
+//# sourceMappingURL=judge-models.d.ts.map

package/dist/cli/lib/parse-run-config/judge-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge-models.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/parse-run-config/judge-models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CAsB9D;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CAQpE"}

package/dist/cli/lib/parse-run-config/judge-models.js

@@ -0,0 +1,55 @@
+/**
+ * `--judge-models` CLI 参数解析。
+ *
+ * 输入格式: `executor:model[,executor:model,...]`
+ *   - 1 entry = 单评委
+ *   - ≥ 2 entry = ensemble(是否接受由调用方决定)
+ *
+ * 校验语义:
+ *   - 空字符串 / 全空 entry 抛错(避免 silent default)
+ *   - entry 必须是 `executor:model`,缺一报错
+ *   - 重复 `executor:model` 拒绝 —— ensemble 聚合用 `Map<judgeId, scores>` 会把
+ *     同 id 合并,N 不可信、agreement 失真;而 grading 阶段又会按 entry 数实际跑
+ *     N 次,产生「跑了但聚合不到」的隐藏成本
+ *
+ * 两个公开符号:
+ *   - `parseJudgeModelsArg`: 纯函数,throw Error,供单测断言文案
+ *   - `parseJudgeModelsArgOrExit`: CLI 友好封装,catch 后 stderr + CliExit(2),
+ *     给 `eval` / `evolve` 子命令共用(exit 2 = parser/参数错误,区别于
+ *     doctor / gate eval failure 的 exit 1)
+ */
+import { CliExit } from '../cli-exit.js';
+export function parseJudgeModelsArg(raw) {
+    const parts = raw.split(',').map((s) => s.trim()).filter(Boolean);
+    if (parts.length === 0) {
+        throw new Error(`--judge-models cannot be empty`);
+    }
+    const result = [];
+    const seen = new Set();
+    for (const p of parts) {
+        const idx = p.indexOf(':');
+        if (idx <= 0 || idx === p.length - 1) {
+            throw new Error(`--judge-models entry must be 'executor:model' (got "${p}")`);
+        }
+        const executor = p.slice(0, idx);
+        const model = p.slice(idx + 1);
+        const key = `${executor}:${model}`;
+        if (seen.has(key)) {
+            throw new Error(`--judge-models has duplicate entry "${key}"; ensemble 聚合按 executor:model 去重,重复条目会让 N 不可信、agreement 失真`);
+        }
+        seen.add(key);
+        result.push({ executor, model });
+    }
+    return result;
+}
+export function parseJudgeModelsArgOrExit(raw) {
+    try {
+        return parseJudgeModelsArg(raw);
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`error: ${msg}`);
+        throw new CliExit(2);
+    }
+}
+//# sourceMappingURL=judge-models.js.map

package/dist/cli/lib/parse-run-config/judge-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge-models.js","sourceRoot":"","sources":["../../../../src/cli/lib/parse-run-config/judge-models.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAGzC,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAClE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,GAAG,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,IAAI,CAAC,CAAC;QAChF,CAAC;QACD,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAG,GAAG,QAAQ,IAAI,KAAK,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,uCAAuC,GAAG,6DAA6D,CAAC,CAAC;QAC3H,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACd,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,GAAW;IACnD,IAAI,CAAC;QACH,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,CAAC,KAAK,CAAC,UAAU,GAAG,EAAE,CAAC,CAAC;QAC/B,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/cli/lib/parse-run-config/samples-discovery.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 当 CLI 未传 `--samples` 时,自动发现 sample 路径。
+ *
+ * 发现顺序(单 treatment 模式):
+ *   1. treatment 是绝对 / 相对路径(文件 / 目录) → 找它所在目录的 `.omk/`
+ *   2. fallback 找目录里的 `eval-samples.{json,yaml,yml}`
+ *   3. fallback `<skillDir>/<treatmentName>/.omk/`
+ *   4. 终极兜底 cwd 下的 `eval-samples.{json,yaml,yml}`
+ *
+ * `loadSamples` 在下游自己处理「文件 vs 目录」—— 目录模式 glob `*.{json,yaml,yml}`
+ * 合并,跳过 reserved 前缀(`report-` / `health-` / `_`)。所以一个 skill 可以把
+ * sample 拆到多文件(`workflow.json` + `platform.json`),也可以单 `samples.json`,
+ * 两种都行。
+ *
+ * 多 treatment 评测必须显式传 `--samples`(因为「找哪个 skill 的 bundled samples」
+ * 没有唯一答案)。本函数仅处理单 treatment 与零 treatment 情况。
+ */
+export declare function discoverSamplesPath(values: Record<string, unknown>, skillDir: string): string;
+//# sourceMappingURL=samples-discovery.d.ts.map

package/dist/cli/lib/parse-run-config/samples-discovery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"samples-discovery.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/parse-run-config/samples-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA0B7F"}

package/dist/cli/lib/parse-run-config/samples-discovery.js

@@ -0,0 +1,53 @@
+/**
+ * 当 CLI 未传 `--samples` 时,自动发现 sample 路径。
+ *
+ * 发现顺序(单 treatment 模式):
+ *   1. treatment 是绝对 / 相对路径(文件 / 目录) → 找它所在目录的 `.omk/`
+ *   2. fallback 找目录里的 `eval-samples.{json,yaml,yml}`
+ *   3. fallback `<skillDir>/<treatmentName>/.omk/`
+ *   4. 终极兜底 cwd 下的 `eval-samples.{json,yaml,yml}`
+ *
+ * `loadSamples` 在下游自己处理「文件 vs 目录」—— 目录模式 glob `*.{json,yaml,yml}`
+ * 合并,跳过 reserved 前缀(`report-` / `health-` / `_`)。所以一个 skill 可以把
+ * sample 拆到多文件(`workflow.json` + `platform.json`),也可以单 `samples.json`,
+ * 两种都行。
+ *
+ * 多 treatment 评测必须显式传 `--samples`(因为「找哪个 skill 的 bundled samples」
+ * 没有唯一答案)。本函数仅处理单 treatment 与零 treatment 情况。
+ */
+import { resolve, join, dirname } from 'node:path';
+import { existsSync, statSync } from 'node:fs';
+import { parseVariantCwd } from '../../../inputs/skill-loader.js';
+export function discoverSamplesPath(values, skillDir) {
+    const treatmentRaw = values.treatment;
+    const treatments = treatmentRaw
+        ? treatmentRaw.split(',').map((v) => v.trim()).filter(Boolean)
+        : [];
+    if (treatments.length === 1) {
+        const expr = treatments[0];
+        const resolved = resolve(expr);
+        if (existsSync(resolved)) {
+            const treatmentDir = statSync(resolved).isDirectory() ? resolved : dirname(resolved);
+            const omkDir = join(treatmentDir, '.omk');
+            if (existsSync(omkDir))
+                return omkDir;
+            for (const name of ['eval-samples.json', 'eval-samples.yaml', 'eval-samples.yml']) {
+                if (existsSync(join(treatmentDir, name)))
+                    return join(treatmentDir, name);
+            }
+        }
+        const tname = parseVariantCwd(expr).name;
+        const omkDir = join(skillDir, tname, '.omk');
+        if (existsSync(omkDir))
+            return omkDir;
+    }
+    let cwdFile = 'eval-samples.json';
+    if (!existsSync(resolve(cwdFile))) {
+        if (existsSync(resolve('eval-samples.yaml')))
+            cwdFile = 'eval-samples.yaml';
+        else if (existsSync(resolve('eval-samples.yml')))
+            cwdFile = 'eval-samples.yml';
+    }
+    return cwdFile;
+}
+//# sourceMappingURL=samples-discovery.js.map

package/dist/cli/lib/parse-run-config/samples-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"samples-discovery.js","sourceRoot":"","sources":["../../../../src/cli/lib/parse-run-config/samples-discovery.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAElE,MAAM,UAAU,mBAAmB,CAAC,MAA+B,EAAE,QAAgB;IACnF,MAAM,YAAY,GAAG,MAAM,CAAC,SAA+B,CAAC;IAC5D,MAAM,UAAU,GAAG,YAAY;QAC7B,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QAC9D,CAAC,CAAC,EAAE,CAAC;IACP,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;QAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACrF,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;YAC1C,IAAI,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,MAAM,CAAC;YACtC,KAAK,MAAM,IAAI,IAAI,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,kBAAkB,CAAC,EAAE,CAAC;gBAClF,IAAI,UAAU,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;oBAAE,OAAO,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YAC5E,CAAC;QACH,CAAC;QACD,MAAM,KAAK,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC7C,IAAI,UAAU,CAAC,MAAM,CAAC;YAAE,OAAO,MAAM,CAAC;IACxC,CAAC;IACD,IAAI,OAAO,GAAG,mBAAmB,CAAC;IAClC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;QAClC,IAAI,UAAU,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC;YAAE,OAAO,GAAG,mBAAmB,CAAC;aACvE,IAAI,UAAU,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;YAAE,OAAO,GAAG,kBAAkB,CAAC;IACjF,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/cli/lib/parse-run-config/variant-resolution.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 解析 `--control` / `--treatment` 与 eval.yaml `variants` 的优先级合并。
+ *
+ * 三态精度:
+ *   - CLI roles 出现(--control 或 --treatment 任一) → 完全替换 config.variants
+ *     (no merging)。CLI 跟 yaml 同时给意味着用户在 override yaml,合并会让
+ *     control / treatment 角色和「跑哪些 variant」两件事纠缠
+ *   - 仅 yaml → 用 `configVariantsToSpecs` 转换
+ *   - 仅 batch 模式 → 留空,batch workflow 自己生成(baseline vs 每个 skill)
+ *   - 都没有 → throw,附带 skill-dir 下候选 variant 提示,引导显式声明
+ *
+ * 之后做 variant name 唯一性检查 —— 同名 variant 不能同时在 --control 和
+ * --treatment,也不能 --treatment 内重复。否则 ensemble agreement / report 字段
+ * 都会按 name 去重,跑了但聚不到。
+ */
+import type { EvalConfig, VariantSpec } from '../../../types/index.js';
+export declare function resolveVariantSpecs(values: Record<string, unknown>, evalConfig: EvalConfig | null, skillDir: string): VariantSpec[];
+//# sourceMappingURL=variant-resolution.d.ts.map

package/dist/cli/lib/parse-run-config/variant-resolution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant-resolution.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/parse-run-config/variant-resolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEvE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,EAAE,UAAU,GAAG,IAAI,EAC7B,QAAQ,EAAE,MAAM,GACf,WAAW,EAAE,CA4Cf"}

package/dist/cli/lib/parse-run-config/variant-resolution.js

@@ -0,0 +1,59 @@
+/**
+ * 解析 `--control` / `--treatment` 与 eval.yaml `variants` 的优先级合并。
+ *
+ * 三态精度:
+ *   - CLI roles 出现(--control 或 --treatment 任一) → 完全替换 config.variants
+ *     (no merging)。CLI 跟 yaml 同时给意味着用户在 override yaml,合并会让
+ *     control / treatment 角色和「跑哪些 variant」两件事纠缠
+ *   - 仅 yaml → 用 `configVariantsToSpecs` 转换
+ *   - 仅 batch 模式 → 留空,batch workflow 自己生成(baseline vs 每个 skill)
+ *   - 都没有 → throw,附带 skill-dir 下候选 variant 提示,引导显式声明
+ *
+ * 之后做 variant name 唯一性检查 —— 同名 variant 不能同时在 --control 和
+ * --treatment,也不能 --treatment 内重复。否则 ensemble agreement / report 字段
+ * 都会按 name 去重,跑了但聚不到。
+ */
+import { discoverVariants, parseVariantCwd } from '../../../inputs/skill-loader.js';
+import { configVariantsToSpecs } from '../../../inputs/eval-config.js';
+export function resolveVariantSpecs(values, evalConfig, skillDir) {
+    const controlExpr = values.control;
+    const treatmentExprs = values.treatment
+        ? values.treatment.split(',').map((v) => v.trim()).filter(Boolean)
+        : [];
+    let variantSpecs;
+    if (controlExpr || treatmentExprs.length > 0) {
+        // CLI roles present → CLI entirely replaces config.variants (no merging).
+        variantSpecs = [];
+        if (controlExpr) {
+            variantSpecs.push({ name: parseVariantCwd(controlExpr).name, role: 'control', expr: controlExpr });
+        }
+        for (const expr of treatmentExprs) {
+            variantSpecs.push({ name: parseVariantCwd(expr).name, role: 'treatment', expr });
+        }
+    }
+    else if (evalConfig) {
+        variantSpecs = configVariantsToSpecs(evalConfig.variants);
+    }
+    else if (values.batch) {
+        // --batch 模式自动用 baseline (control) vs 每个 skill (treatment),
+        // 不需要用户显式传 --control / --treatment,校验跳过。
+        variantSpecs = [];
+    }
+    else {
+        const discovered = discoverVariants(skillDir);
+        const hint = discovered.length > 0 ? `\n  skill-dir (${skillDir}) 下发现的候选：${discovered.join(', ')}` : '';
+        throw new Error(`请通过 --control / --treatment 或 --config eval.yaml 声明 variant 角色。\n`
+            + `  示例：omk eval --control baseline --treatment my-skill${hint}\n`
+            + `  --batch 模式下自动用 baseline vs 每个 skill,无需显式声明\n`
+            + `  术语见 docs/specs/terminology-spec.md（v0.16 起废除 --variants，改用 experiment role 显式声明）`);
+    }
+    const seenNames = new Set();
+    for (const spec of variantSpecs) {
+        if (seenNames.has(spec.name)) {
+            throw new Error(`variant "${spec.name}" 重复出现——同一 variant 不能同时属于 --control 与 --treatment，也不能在 --treatment 中重复。`);
+        }
+        seenNames.add(spec.name);
+    }
+    return variantSpecs;
+}
+//# sourceMappingURL=variant-resolution.js.map

package/dist/cli/lib/parse-run-config/variant-resolution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variant-resolution.js","sourceRoot":"","sources":["../../../../src/cli/lib/parse-run-config/variant-resolution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAGvE,MAAM,UAAU,mBAAmB,CACjC,MAA+B,EAC/B,UAA6B,EAC7B,QAAgB;IAEhB,MAAM,WAAW,GAAG,MAAM,CAAC,OAA6B,CAAC;IACzD,MAAM,cAAc,GAAa,MAAM,CAAC,SAAS;QAC/C,CAAC,CAAE,MAAM,CAAC,SAAoB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACtF,CAAC,CAAC,EAAE,CAAC;IAEP,IAAI,YAA2B,CAAC;IAChC,IAAI,WAAW,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,0EAA0E;QAC1E,YAAY,GAAG,EAAE,CAAC;QAClB,IAAI,WAAW,EAAE,CAAC;YAChB,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACrG,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;YAClC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;SAAM,IAAI,UAAU,EAAE,CAAC;QACtB,YAAY,GAAG,qBAAqB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC5D,CAAC;SAAM,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACxB,4DAA4D;QAC5D,yCAAyC;QACzC,YAAY,GAAG,EAAE,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAC9C,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,QAAQ,YAAY,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACxG,MAAM,IAAI,KAAK,CACb,mEAAmE;cACjE,wDAAwD,IAAI,IAAI;cAChE,gDAAgD;cAChD,oFAAoF,CACvF,CAAC;IACJ,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CACb,YAAY,IAAI,CAAC,IAAI,yEAAyE,CAC/F,CAAC;QACJ,CAAC;QACD,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,YAAY,CAAC;AACtB,CAAC"}

package/dist/cli/lib/parse-run-config.d.ts

@@ -0,0 +1,93 @@
+/**
+ * oclif typed flags → `RunConfig` 装配。
+ *
+ * 主体 `parseRunConfig` 是「CLI > eval.yaml > 硬编码 default」精度链的统一落点 ——
+ * 把 oclif strict 模式接受过的 flag values + 可选 eval.yaml 合并成 eval 子命令运行
+ * 所需的完整 `RunConfig`,后续 `executeEvaluationPipeline` 与 doctor / batch 都从这
+ * 里读字段。
+ *
+ * 3 个 sub-routine 拆到同级 parse-run-config/ 目录,主文件保留它们的 re-export
+ * 让外部 import surface(`parseJudgeModelsArg` / `parseJudgeModelsArgOrExit`)
+ * 不动:
+ *   - judge-models.ts: --judge-models 字符串解析
+ *   - samples-discovery.ts: 未传 --samples 时的路径发现
+ *   - variant-resolution.ts: --control / --treatment / eval.yaml.variants 三态合并
+ *
+ * 主体 parseRunConfig 自身保留约 100 行的 field-default fanout —— 每个字段一行
+ * `cli ?? evalConfig ?? default`,刻意不再细拆,否则只是把一长串 ?? 散到多文件,
+ * 反而失去「精度链一目了然」的可读性。
+ */
+import type { EvalConfig, VariantSpec, JudgeConfig, EvalBudget, ProgressCallback } from '../../types/index.js';
+export { parseJudgeModelsArg, parseJudgeModelsArgOrExit } from './parse-run-config/judge-models.js';
+export interface RunConfig {
+    samplesPath: string;
+    skillDir: string;
+    variantSpecs: VariantSpec[];
+    model: string | undefined;
+    outputDir: string;
+    noJudge: boolean | undefined;
+    noCache: boolean | undefined;
+    dryRun: boolean | undefined;
+    concurrency: number;
+    timeoutMs: number;
+    executorName: string | undefined;
+    /** 跳过 LLM 模型连通性检测。--resume 时自动 true(已经验过)。 */
+    skipConnectivity: boolean | undefined;
+    /** 跳过 doctor 健康检查门禁(--skip-doctor)。escape hatch — 默认 false。
+     *  开启后 doctor 整段不跑(节省静态检查时间);doctor 失败也不再阻断 eval。
+     *  典型场景:依赖在评测环境中通过 mock / stub 提供,doctor 的物理路径检查
+     *  会误报。开启意味着用户接受 garbage-in 风险,自己负责依赖正确性。 */
+    skipDoctor: boolean | undefined;
+    /** 用户语言, 透传给 doctor 报告渲染。 */
+    lang: 'zh' | 'en' | undefined;
+    mcpConfig: string | undefined;
+    verbose: boolean | undefined;
+    blind?: boolean | undefined;
+    retry?: number;
+    resume?: string;
+    layeredStats?: boolean;
+    /** --judge-repeat N. Calls LLM judge N times per (sample × dimension). Default 1. */
+    judgeRepeat?: number;
+    /** Unified judge config. Always non-empty; 1 entry = single judge, ≥ 2 = ensemble.
+     *  parseRunConfig guarantees at least `[{executor: <executor>, model: 'haiku'}]`. */
+    judgeModels: JudgeConfig[];
+    /** --bootstrap. Adds bootstrap CI to summary (per-variant mean + pairwise diff). */
+    bootstrap?: boolean;
+    /** --bootstrap-samples N. Bootstrap resamples count, default 1000. */
+    bootstrapSamples?: number;
+    /** length-debias toggle. Default true; --no-debias-length sets false. */
+    lengthDebias?: boolean;
+    /** hard budget caps from CLI or config. */
+    budget?: EvalBudget;
+    /** Skill isolation default for baseline-kind variants. Default true.
+     *  CLI flag --no-strict-baseline disables strict isolation. */
+    strictBaseline?: boolean;
+    /** Per-variant allowedSkills override extracted from eval.yaml. Always wins
+     *  over strictBaseline default. Keyed by variant name. */
+    variantAllowedSkills?: Record<string, string[]>;
+    /** Reasoning effort for the executor LLM(被评测的模型,不是 judge)。
+     *  Default 'low' — sonnet 默认会做大量扩展思考(13K thinking tokens / 单次),
+     *  对结构化任务是浪费。低 effort 大幅省时间/成本但可能损失复杂推理质量,
+     *  跨 effort 的报告不能严格比较。`undefined` 走 claude CLI / SDK 自身默认。 */
+    effort?: 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+    /** 关闭 diagnostic LLM call。Default false(总是给 failed sample 跑诊断)。
+     *  跟 noJudge 完全独立 — judge 答打分,diagnostic 答怎么改。 */
+    noDiagnostic?: boolean;
+    onProgress?: ProgressCallback | null;
+}
+export interface ParseRunConfigResult {
+    values: Record<string, string | boolean | undefined>;
+    config: RunConfig;
+    /** Loaded eval.yaml when --config was provided. `commands/eval-runner.ts` uses it to apply
+     *  CLI > eval.yaml > default fallback for fields not propagated by parseRunConfig
+     *  (e.g. repeat / judgeRepeat / bootstrap — handled in `commands/eval-runner.ts` for input validation). */
+    evalConfig: EvalConfig | null;
+}
+export declare const DEFAULT_REPORTS_DIR: string;
+/**
+ * 接 typed flags(来自 oclif Command.parse() 输出)。oclif strict 模式已经在
+ * 上游对未知 flag 拦截 exit 2,这里不再 parseArgs。eval-runner 等业务 caller
+ * 把 oclif flags 当 values 喂进来。
+ */
+export declare function parseRunConfig(values: Record<string, unknown>): ParseRunConfigResult;
+//# sourceMappingURL=parse-run-config.d.ts.map

package/dist/cli/lib/parse-run-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-run-config.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/parse-run-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,OAAO,KAAK,EACV,UAAU,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,gBAAgB,EACjB,MAAM,sBAAsB,CAAC;AAK9B,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAEpG,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,8CAA8C;IAC9C,gBAAgB,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC;;;iDAG6C;IAC7C,UAAU,EAAE,OAAO,GAAG,SAAS,CAAC;IAChC,6BAA6B;IAC7B,IAAI,EAAE,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,qFAAqF;IACrF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;yFACqF;IACrF,WAAW,EAAE,WAAW,EAAE,CAAC;IAC3B,oFAAoF;IACpF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;mEAC+D;IAC/D,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;8DAC0D;IAC1D,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAChD;;;kEAG8D;IAC9D,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,CAAC;IACrD;sDACkD;IAClD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IACrD,MAAM,EAAE,SAAS,CAAC;IAClB;;+GAE2G;IAC3G,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;CAC/B;AAED,eAAO,MAAM,mBAAmB,EAAE,MAAuD,CAAC;AAE1F;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,oBAAoB,CAsItB"}