oh-my-knowledge 1.0.0-beta.5 → 1.0.0-beta.7

package/dist/assets/agent-skills/omk/references/commands.md

@@ -73,7 +73,7 @@ omk eval [flags]
 
 **Flags:**
 
-- `--batch` `boolean`:batch 模式：baseline 作为对照组，逐个 skill 作为实验组
+- `--batch` `boolean`:批量评测：baseline 作为对照组，逐个 skill 作为实验组；不支持 repeat 大于 1
 - `--bootstrap` `boolean`:加 bootstrap CI
 - `--bootstrap-samples` `option`:bootstrap 重采样次数，默认 1000
 - `--budget-per-sample-ms` `option`:单用例时长上限 ms（必须 > 0，不传则无上限）
@@ -95,7 +95,6 @@ omk eval [flags]
 - `--layered-stats` `boolean`:输出分层统计
 - `--mcp-config` `option`:MCP 配置文件路径
 - `--model` `option`:被测模型
-- `--no-cache` `boolean`:跳过 executor cache
 - `--no-debias-length` `boolean`:关 length-debias（默认开）
 - `--no-diagnostic` `boolean`:关闭基于 Core 失败、缺失、排除与稳定 reason code 的诊断投影。
 - `--no-evidence` `boolean`:不把本次评测写成证据追加进受管记录(默认会为已 install 的 skill 自动写)。

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

@@ -1,11 +1,5 @@
-// oclif 版 eval gold topic shim — 裸 `omk eval gold` 走 oclif Help class 打 topic
-// help,然后 exit 1(跟 legacy CliExit(1) 行为对齐:CI 脚本靠 exit code 区分「漏写
-// sub-sub」)。
-//
-// 不再依赖 legacy hand-written usage() 字符串(已删):oclif 默认没内建 help command,
-// 但 helpClass 是可实例化的 Help 子类。直接 new HelpClass(config).showCommandHelp(
-// config.findCommand('eval:gold')) 让 LangAwareHelp 按 --lang 渲染当前 topic 的
-// description + sub-sub 列表(init / validate / compare)。
+// 裸 `omk eval gold` 显示帮助并退出 1，让自动化能识别缺少子命令。
+// 复用当前 HelpClass，保持语言选择和子命令列表与 CLI 一致。
 import { BaseCommand } from '../../../oclif/base-command.js';
 import { LANG_FLAG, bilingual } from '../../../oclif/i18n.js';
 export default class EvalGold extends BaseCommand {

package/dist/cli/commands/eval/index.d.ts

@@ -1,7 +1,15 @@
 import { BaseCommand } from '../../oclif/base-command.js';
 import { type CliLang } from '../../lib/i18n.js';
-import { type RunConfig } from '../../lib/parse-run-config.js';
-export declare function formatConnectivityFailureHint(message: string, config: Pick<RunConfig, 'executorName' | 'model' | 'judgeModels' | 'noJudge'>, lang: CliLang, env?: NodeJS.ProcessEnv): string;
+interface ConnectivityFailureContext {
+    executorName: string;
+    model: string;
+    judgeModels: readonly {
+        executor: string;
+        model: string;
+    }[];
+    noJudge: boolean;
+}
+export declare function formatConnectivityFailureHint(message: string, config: Pick<ConnectivityFailureContext, 'executorName' | 'model' | 'judgeModels' | 'noJudge'>, lang: CliLang, env?: NodeJS.ProcessEnv): string;
 export default class Eval extends BaseCommand {
     static description: string;
     static examples: {
@@ -23,7 +31,6 @@ export default class Eval extends BaseCommand {
         'output-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'no-judge': import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        'no-cache': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         'dry-run': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         concurrency: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         timeout: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
@@ -58,3 +65,4 @@ export default class Eval extends BaseCommand {
     };
     run(): Promise<void>;
 }
+export {};

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

@@ -1,12 +1,13 @@
 import { existsSync } from 'node:fs';
-import { join, relative, sep } from 'node:path';
+import { join, relative, resolve, sep } from 'node:path';
 import { Flags } from '@oclif/core';
 import { LANG_FLAG, bilingual } from '../../oclif/i18n.js';
 import { BaseCommand } from '../../oclif/base-command.js';
 import { enumStringParser, integerStringParser, numberStringParser } from '../../oclif/parsers.js';
 import { CliExit } from '../../lib/cli-exit.js';
 import { tCli } from '../../lib/i18n.js';
-import { parseRunConfig } from '../../lib/parse-run-config.js';
+import { prepareCliEvaluation } from '../../lib/prepare-evaluation.js';
+import { CliEvaluationInputError } from '../../../eval-workflows/hosts/application.js';
 import { codexModelFlagValue, codexModelHint } from '../../lib/codex-model-hint.js';
 import { looksLikeModelUnavailableFailure } from '../../lib/llm-failure-classifier.js';
 import { DEFAULT_EVALUATION_GATE_THRESHOLD as DEFAULT_GATE_THRESHOLD } from '../../../eval-workflows/evaluation-defaults.js';
@@ -15,7 +16,7 @@ import { shellQuoteArg } from '../../../shared/shell-quote.js';
 import { executorNamesForFamily } from '../../../executors/core/registry.js';
 import { DEFAULT_EVALUATION_TIMEOUT_MS } from '../../../eval-workflows/evaluation-defaults.js';
 // oclif 版 eval(默认 = run 模式) — 单次 typed parse 之后业务 inline。flag schema
-// 镜像 RUN_OPTIONS + eval-runner extra = 41 flag。具体语义跟约束在 parseRunConfig 里。
+// 参数语义与约束由 Workflow 的 parseCliEvaluationRequest 维护。
 //
 // `omk eval gold ...` 由 src/cli/commands/eval/gold/{init,validate,compare}.ts
 // 处理,oclif 文件目录路由自动接管,不进 eval.ts。
@@ -127,15 +128,29 @@ export function formatConnectivityFailureHint(message, config, lang, env = proce
     return '';
 }
 async function runEval(_args, flags, lang) {
-    const { values, config, evalConfig } = parseRunConfig({ ...flags }, { lang });
-    if (!values.batch && !hasUsableSamplesPath(config.samplesPath)) {
+    let prepared;
+    try {
+        prepared = prepareCliEvaluation({ ...flags }, { lang });
+    }
+    catch (error) {
+        if (!(error instanceof CliEvaluationInputError))
+            throw error;
+        console.error(`error: ${error.message}`);
+        throw new CliExit(2);
+    }
+    const { request } = prepared;
+    const values = flags;
+    const evalConfig = prepared.parseInput.evalConfig;
+    const samplesPath = resolve(prepared.projectRoot, request.values.locators.samples);
+    const skillDir = resolve(prepared.projectRoot, request.values.locators.skillDirectory);
+    if (!values.batch && !hasUsableSamplesPath(samplesPath)) {
         const treatmentRaw = typeof values.treatment === 'string' ? values.treatment : '';
         const treatments = treatmentRaw.split(',').map((v) => v.trim()).filter(Boolean);
         const sampleCommand = !values.samples && !evalConfig?.samples && treatments.length === 1
-            ? sampleCommandForSingleTreatment(treatments[0], config.skillDir)
+            ? sampleCommandForSingleTreatment(treatments[0], skillDir)
             : null;
         const missingSamplesMessage = [
-            tCli('cli.common.samples_not_found', lang, { path: config.samplesPath }),
+            tCli('cli.common.samples_not_found', lang, { path: samplesPath }),
             sampleCommand ? tCli('cli.common.samples_not_found_hint', lang, { command: sampleCommand }) : '',
         ].filter(Boolean).join('\n');
         console.error(tCli('cli.common.error_prefix', lang, {
@@ -145,12 +160,7 @@ async function runEval(_args, flags, lang) {
     }
     try {
         const { runCoreEvaluationCommand } = await import('../../lib/run-core-evaluation.js');
-        const result = await runCoreEvaluationCommand({
-            flags: { ...flags },
-            config,
-            evalConfig,
-            lang,
-        });
+        const result = await runCoreEvaluationCommand({ prepared });
         if (!process.stdout.isTTY || result.output && typeof result.output === 'object'
             && result.output.projectionKind === 'core-cli-dry-run') {
             console.log(JSON.stringify(result.output, null, 2));
@@ -171,7 +181,12 @@ async function runEval(_args, flags, lang) {
             throw err;
         const message = err instanceof Error ? err.message : String(err);
         console.error(tCli('cli.common.error_prefix', lang, {
-            message: `${message}${formatConnectivityFailureHint(message, config, lang)}`,
+            message: `${message}${formatConnectivityFailureHint(message, {
+                executorName: request.values.targetRuntime.executorId,
+                model: request.values.targetRuntime.model,
+                noJudge: !request.values.judges.enabled,
+                judgeModels: request.values.judges.members.map((member) => ({ executor: member.executorId, model: member.model })),
+            }, lang, prepared.environment.environment)}`,
         }));
         throw new CliExit(1);
     }
@@ -262,9 +277,6 @@ export default class Eval extends BaseCommand {
         'no-judge': Flags.boolean({
             description: bilingual({ zh: '跳过 LLM 评委', en: 'Skip LLM judge' }),
         }),
-        'no-cache': Flags.boolean({
-            description: bilingual({ zh: '跳过 executor cache', en: 'Skip executor cache' }),
-        }),
         'dry-run': Flags.boolean({
             description: bilingual({ zh: '只 plan 不实跑', en: 'Plan only, no real exec' }),
         }),
@@ -281,8 +293,8 @@ export default class Eval extends BaseCommand {
         }),
         batch: Flags.boolean({
             description: bilingual({
-                zh: 'batch 模式：baseline 作为对照组，逐个 skill 作为实验组',
-                en: 'Batch mode: baseline vs each skill',
+                zh: '批量评测：baseline 作为对照组，逐个 skill 作为实验组；不支持 repeat 大于 1',
+                en: 'Batch mode: baseline vs each skill; repeat must be 1',
             }),
         }),
         'skip-connectivity': Flags.boolean({

package/dist/cli/commands/evolve.js

@@ -92,7 +92,7 @@ export async function runEvolve(args, flags, lang) {
         samplesFile = resolvedInput.samplesPath;
     }
     // 参数校验必须早于任何昂贵副作用(自动生成用例 / LLM 调用)。
-    const { parseJudgeModelsArgOrExit } = await import('../lib/parse-run-config.js');
+    const { parseJudgeModelsArgOrExit } = await import('../lib/parse-run-config/judge-models.js');
     const evolveJudges = parseJudgeModelsArgOrExit(flags['judge-models']);
     if (evolveJudges.length > 1) {
         console.error(tCli('cli.common.judge_models_single_only', lang, { cmd: 'omk evolve' }));
@@ -168,13 +168,15 @@ export async function runEvolve(args, flags, lang) {
     }
     const { evolveSkillCore } = await import('../../knowledge-artifacts/authoring/core-evolver.js');
     const { runCoreEvaluationCommand } = await import('../lib/run-core-evaluation.js');
+    const { prepareCliEvaluation } = await import('../lib/prepare-evaluation.js');
     const evolveEffort = flags.effort ? validateEvolveEffort(flags.effort, lang) : undefined;
     const evaluatePair = async (control, treatment) => {
         const evaluation = await runCoreEvaluationCommand({
-            flags: {
+            prepared: prepareCliEvaluation({
                 control,
                 treatment,
                 samples: resolve(samplesFile),
+                'skill-dir': dirname(resolve(skillPath)),
                 executor: flags.executor,
                 model: flags.model,
                 'judge-models': evolveJudges.map((judge) => `${judge.executor}:${judge.model}`).join(','),
@@ -185,17 +187,7 @@ export async function runEvolve(args, flags, lang) {
                 'no-evidence': true,
                 'no-serve': true,
                 'report-only': true,
-            },
-            config: {
-                samplesPath: resolve(samplesFile),
-                skillDir: dirname(resolve(skillPath)),
-                executorName: flags.executor,
-                model: flags.model,
-                effort: evolveEffort,
-                judgeModels: evolveJudges,
-            },
-            evalConfig: null,
-            lang: 'zh',
+            }, { lang: 'zh' }),
         });
         if (evaluation.stored === undefined) {
             throw new Error('Core evolve evaluation 未持久化 artifact chain。');

package/dist/cli/commands/init.js

@@ -91,8 +91,7 @@ export default class Init extends BaseCommand {
             }),
             required: false,
             parse: async (input) => {
-                // 拒绝 `omk init -- --weird` 这种把 flag 当 positional 的写法 — legacy 会
-                // 创建名为 `--weird` 的目录,新人一头雾水。在 oclif Args 这层拦住更友好。
+                // 在参数解析阶段拒绝疑似遗漏的 flag，避免误建名为 `--weird` 的目录。
                 if (input.startsWith('--')) {
                     const lang = resolveLang();
                     const msg = lang === 'zh'

package/dist/cli/commands/install.js

@@ -6,7 +6,7 @@ import { Args, 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, resolveRemoteGitSource, SourceResolveError } from '../../eval-workflows/inputs/source-resolver.js';
+import { resolveInstallSource, resolveRemoteGitSource, SourceResolveError } from '../../knowledge-artifacts/sources/install-source.js';
 import { buildManagedArtifactRecord, hashArtifactSource, distributableCopyFilter, managedDir, recordManagedArtifact } from '../../knowledge-artifacts/governance/index.js';
 const BUILTIN_OMK_AGENT_SKILL_ID = 'omk-agent-skill';
 const INSTALLABLE_KINDS = ['skill', 'prompt', 'agent', 'workflow'];

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

@@ -114,7 +114,9 @@ export async function runObserveInbox(_args, flags, lang) {
         items = items.slice(0, limit);
     }
     if (flags.json) {
-        console.log(JSON.stringify({ kind: 'observe-inbox-query', items }, null, 2));
+        const { buildObservationInboxViewModel } = await import('../../../observability/inbox/view-model.js');
+        const { effectiveExperienceReports, resolvedReviewSessions, unappliedMetricAnnotations } = buildObservationInboxViewModel(dir, { skill: flags.skill });
+        console.log(JSON.stringify({ kind: 'observe-inbox-query', items, effectiveExperienceReports, resolvedReviewSessions, unappliedMetricAnnotations }, null, 2));
         return;
     }
     if (items.length === 0) {

package/dist/cli/commands/promote.js

@@ -1,4 +1,4 @@
-import { execFileSync } from 'node:child_process';
+import { resolveActor } from '../lib/actor.js';
 import { Args, Flags } from '@oclif/core';
 import { LANG_FLAG, bilingual } from '../oclif/i18n.js';
 import { BaseCommand } from '../oclif/base-command.js';
@@ -7,18 +7,6 @@ import { CliExit } from '../lib/cli-exit.js';
 import { sanitizeCell } from '../lib/cell-format.js';
 import { appendManagedDecision, evaluatePromoteGate, globalManagedDir, isCurrentlyPromoted, loadManagedRecord, probeSourceState, managedDir, managedRecordId, resolveManagedDir, } from '../../knowledge-artifacts/governance/index.js';
 const SUPPORTED_KINDS = ['skill'];
-/** 决定的 actor:--actor > git config user.name > $USER / $LOGNAME > unknown。git 参数无用户输入,安全。 */
-function resolveActor(flagActor) {
-    if (flagActor && flagActor.trim())
-        return flagActor.trim();
-    try {
-        const name = execFileSync('git', ['config', 'user.name'], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
-        if (name)
-            return name;
-    }
-    catch { /* git 缺失 / 无配置 → 回退环境 */ }
-    return process.env.USER || process.env.LOGNAME || 'unknown';
-}
 /** 洗 detail 里来自受管 JSON 的不可信值(verdict / judgePromptHash),文本输出防 ANSI/OSC 注入。 */
 function safeDetail(detail) {
     if (!detail)

package/dist/cli/commands/rollback.js

@@ -1,4 +1,4 @@
-import { execFileSync } from 'node:child_process';
+import { resolveActor } from '../lib/actor.js';
 import { Args, Flags } from '@oclif/core';
 import { LANG_FLAG, bilingual } from '../oclif/i18n.js';
 import { BaseCommand } from '../oclif/base-command.js';
@@ -7,18 +7,6 @@ import { CliExit } from '../lib/cli-exit.js';
 import { sanitizeCell } from '../lib/cell-format.js';
 import { appendManagedDecision, globalManagedDir, isCurrentlyPromoted, loadManagedRecord, managedDir, managedRecordId, resolveManagedDir, } from '../../knowledge-artifacts/governance/index.js';
 const SUPPORTED_KINDS = ['skill'];
-/** 决定的 actor:--actor > git config user.name > $USER / $LOGNAME > unknown。git 参数无用户输入,安全。 */
-function resolveActor(flagActor) {
-    if (flagActor && flagActor.trim())
-        return flagActor.trim();
-    try {
-        const name = execFileSync('git', ['config', 'user.name'], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
-        if (name)
-            return name;
-    }
-    catch { /* git 缺失 / 无配置 → 回退环境 */ }
-    return process.env.USER || process.env.LOGNAME || 'unknown';
-}
 export default class Rollback extends BaseCommand {
     static description = bilingual({
         zh: '回退受管 skill 当前版本的 promoted 接受：撤销最近一次 promote，在记录里追加一条 rollback 决定（源未漂移则状态回到 measurable，源已漂移则仍 stale）。',

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

@@ -0,0 +1,2 @@
+/** Resolve a decision actor from the flag, Git config, environment, then fallback. */
+export declare function resolveActor(flagActor: string | undefined): string;

package/dist/cli/lib/actor.js

@@ -0,0 +1,13 @@
+import { execFileSync } from 'node:child_process';
+/** Resolve a decision actor from the flag, Git config, environment, then fallback. */
+export function resolveActor(flagActor) {
+    if (flagActor && flagActor.trim())
+        return flagActor.trim();
+    try {
+        const name = execFileSync('git', ['config', 'user.name'], { encoding: 'utf-8', stdio: ['ignore', 'pipe', 'ignore'] }).trim();
+        if (name)
+            return name;
+    }
+    catch { /* git 缺失 / 无配置 → 回退环境 */ }
+    return process.env.USER || process.env.LOGNAME || 'unknown';
+}

package/dist/cli/lib/cmd-flags.d.ts

@@ -36,7 +36,7 @@
  *   优先级 `--lang CLI flag > OMK_LANG env > zh`。
  *
  * 三态 boolean 注意:oclif 对 `Flags.boolean({})`(没 `default`)运行时不会塞 `false`,
- * 而是字段缺失,字段读出来是 `undefined`。这点对 `eval` 跟 `parseRunConfig()` fallback
+ * 而是字段缺失,字段读出来是 `undefined`。这点对 `eval` 跟 `parseCliEvaluationRequest()` fallback
  * 关键 — `undefined`(CLI 没传)走 `eval.yaml` config / 内置 default;`false`(显式
  * `--no-xxx`)真的关。如果在 interface 里把它标成 `boolean`,后续维护者按类型读
  * `flags.bootstrap` 会静默把「没传」当成「关」,绕开 config fallback。所以未设
@@ -80,7 +80,6 @@ export interface EvalFlags {
     /** 报告写全局而非项目 .omk/eval(写入侧 escape;读取侧 studio / 复用走 overlay 兜底)。 */
     global?: boolean;
     'no-judge'?: boolean;
-    'no-cache'?: boolean;
     'dry-run'?: boolean;
     concurrency?: string;
     timeout?: string;

package/dist/cli/lib/cmd-flags.js

@@ -36,7 +36,7 @@
  *   优先级 `--lang CLI flag > OMK_LANG env > zh`。
  *
  * 三态 boolean 注意:oclif 对 `Flags.boolean({})`(没 `default`)运行时不会塞 `false`,
- * 而是字段缺失,字段读出来是 `undefined`。这点对 `eval` 跟 `parseRunConfig()` fallback
+ * 而是字段缺失,字段读出来是 `undefined`。这点对 `eval` 跟 `parseCliEvaluationRequest()` fallback
  * 关键 — `undefined`(CLI 没传)走 `eval.yaml` config / 内置 default;`false`(显式
  * `--no-xxx`)真的关。如果在 interface 里把它标成 `boolean`,后续维护者按类型读
  * `flags.bootstrap` 会静默把「没传」当成「关」,绕开 config fallback。所以未设

package/dist/cli/lib/evaluation-composition.d.ts

@@ -0,0 +1,3 @@
+import { type NodeEvaluationEnvironment, type ClassifiedEnvironmentEntry } from '../../eval-workflows/hosts/application.js';
+export declare function classifyNodeCliEnvironment(environment: NodeJS.ProcessEnv): Readonly<Record<string, ClassifiedEnvironmentEntry>>;
+export declare function captureNodeCliEvaluationEnvironment(environment?: NodeJS.ProcessEnv): NodeEvaluationEnvironment;

package/dist/cli/lib/evaluation-composition.js

@@ -0,0 +1,96 @@
+import { access, realpath } from 'node:fs/promises';
+import { constants } from 'node:fs';
+import { delimiter, isAbsolute, join } from 'node:path';
+import { NodeCliProductionCompositionError, } from '../../eval-workflows/hosts/application.js';
+const CREDENTIAL_ENVIRONMENT = new Set([
+    'ANTHROPIC_API_KEY',
+    'CLAUDE_CODE_OAUTH_TOKEN',
+    'OPENAI_API_KEY',
+]);
+const SECRET_TAINT_ENVIRONMENT = new Set([
+    'ALL_PROXY',
+    'HTTPS_PROXY',
+    'HTTP_PROXY',
+    'all_proxy',
+    'http_proxy',
+    'https_proxy',
+]);
+const EFFECT_LOCATOR_ENVIRONMENT = new Set([
+    'ALL_PROXY',
+    'CODEX_HOME',
+    'CURL_CA_BUNDLE',
+    'HOME',
+    'HTTPS_PROXY',
+    'HTTP_PROXY',
+    'NODE_EXTRA_CA_CERTS',
+    'NO_PROXY',
+    'PATH',
+    'REQUESTS_CA_BUNDLE',
+    'SSL_CERT_DIR',
+    'SSL_CERT_FILE',
+    'TMPDIR',
+    'XDG_CACHE_HOME',
+    'XDG_CONFIG_HOME',
+    'XDG_DATA_HOME',
+    'all_proxy',
+    'http_proxy',
+    'https_proxy',
+    'no_proxy',
+]);
+const BEHAVIOR_ENVIRONMENT = new Set([
+    'LANG',
+    'LC_ALL',
+    'NO_COLOR',
+]);
+export function classifyNodeCliEnvironment(environment) {
+    const keys = new Set([
+        ...CREDENTIAL_ENVIRONMENT,
+        ...EFFECT_LOCATOR_ENVIRONMENT,
+        ...BEHAVIOR_ENVIRONMENT,
+    ]);
+    return Object.freeze(Object.fromEntries([...keys].sort().flatMap((key) => {
+        const value = environment[key];
+        if (value === undefined)
+            return [];
+        const identity = CREDENTIAL_ENVIRONMENT.has(key)
+            ? { identityKind: 'credential' }
+            : EFFECT_LOCATOR_ENVIRONMENT.has(key)
+                ? { identityKind: 'effect-locator' }
+                : { identityKind: 'behavior', value };
+        return [[key, Object.freeze({
+                    value,
+                    identity,
+                    ...(SECRET_TAINT_ENVIRONMENT.has(key) ? { outputTaint: 'secret' } : {}),
+                })]];
+    })));
+}
+async function resolveExecutable(command, environment) {
+    const candidates = isAbsolute(command)
+        ? [command]
+        : (environment.PATH ?? '').split(delimiter).filter(Boolean).map((directory) => (join(directory, command)));
+    for (const candidate of candidates) {
+        try {
+            await access(candidate, constants.X_OK);
+            return await realpath(candidate);
+        }
+        catch {
+            // Continue through the explicit PATH snapshot.
+        }
+    }
+    throw new NodeCliProductionCompositionError('NODE_CLI_EXECUTABLE_UNAVAILABLE', `执行器「${command}」在当前 PATH 中不可用。`);
+}
+function requiredCredential(environment, key) {
+    const value = environment[key]?.trim();
+    if (value !== undefined && value !== '')
+        return value;
+    throw new NodeCliProductionCompositionError('NODE_CLI_CREDENTIAL_MISSING', `执行器需要环境变量 ${key}。`);
+}
+export function captureNodeCliEvaluationEnvironment(environment = process.env) {
+    const captured = Object.freeze({ ...environment });
+    return Object.freeze({
+        environment: captured,
+        classifiedEnvironment: classifyNodeCliEnvironment(captured),
+        resolveExecutable: (command) => resolveExecutable(command, captured),
+        requiredCredential: (key) => requiredCredential(captured, key),
+    });
+}

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

@@ -1,3 +1,3 @@
 import type { CliMessage } from './types.js';
-export type CommonMessageKey = 'cli.common.unknown_domain' | 'cli.common.error_prefix' | 'cli.common.skill_dir_not_found' | 'cli.common.skill_file_not_found' | 'cli.common.skill_dir_no_skill_md' | 'cli.common.report_not_found' | 'cli.common.no_judge_model' | 'cli.common.judge_models_single_only' | 'cli.common.warn_load_samples_failed' | 'cli.common.ambiguous_sample_files' | 'cli.common.samples_not_found' | 'cli.common.samples_not_found_hint' | 'cli.update.new_version_available' | 'cli.update.box_title' | 'cli.update.box_version_line' | 'cli.update.box_upgrade_line' | 'cli.update.box_silence_line' | 'cli.observe.view_hint' | 'cli.observe.observation_recorded' | 'cli.observe.production_gap' | 'cli.studio.started' | 'cli.studio.stop_hint' | 'cli.studio.open_failed' | 'cli.doctor.no_skill_found' | 'cli.doctor.progress_skill_start' | 'cli.doctor.progress_skill_done';
+export type CommonMessageKey = 'cli.common.unknown_domain' | 'cli.common.error_prefix' | 'cli.common.skill_dir_not_found' | 'cli.common.skill_file_not_found' | 'cli.common.skill_dir_no_skill_md' | 'cli.common.judge_models_single_only' | 'cli.common.ambiguous_sample_files' | 'cli.common.samples_not_found' | 'cli.common.samples_not_found_hint' | 'cli.update.new_version_available' | 'cli.update.box_title' | 'cli.update.box_version_line' | 'cli.update.box_upgrade_line' | 'cli.update.box_silence_line' | 'cli.observe.view_hint' | 'cli.observe.observation_recorded' | 'cli.observe.production_gap' | 'cli.studio.started' | 'cli.studio.stop_hint' | 'cli.studio.open_failed' | 'cli.doctor.no_skill_found' | 'cli.doctor.progress_skill_start' | 'cli.doctor.progress_skill_done';
 export declare const commonDict: Record<CommonMessageKey, CliMessage>;

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

@@ -19,22 +19,10 @@ export const commonDict = {
         zh: '目录下未找到 SKILL.md: {path}',
         en: 'SKILL.md not found in directory: {path}',
     },
-    'cli.common.report_not_found': {
-        zh: '未找到 report: {id}',
-        en: 'Report not found: {id}',
-    },
-    'cli.common.no_judge_model': {
-        zh: '未指定评委。请加 --judge-models <executor:model>, 或确保 report.meta.judgeModels 已写。',
-        en: 'No judge configured. Pass --judge-models <executor:model> or ensure the report has meta.judgeModels.',
-    },
     'cli.common.judge_models_single_only': {
         zh: '{cmd} 仅支持单评委。--judge-models 只能传一个 executor:model entry。',
         en: '{cmd} only supports a single judge. --judge-models accepts exactly one executor:model entry.',
     },
-    'cli.common.warn_load_samples_failed': {
-        zh: '⚠ 加载 samples 文件失败 ({path}): {message}\n',
-        en: '⚠ Failed to load samples file ({path}): {message}\n',
-    },
     'cli.common.ambiguous_sample_files': {
         zh: '评测用例文件存在歧义：{paths}。同一作用域只能保留 eval-samples.json 或 eval-samples.yaml 其中一个。',
         en: 'Ambiguous eval sample files: {paths}. Keep only one of eval-samples.json or eval-samples.yaml in the same scope.',

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

@@ -1,3 +1,3 @@
 import type { CliMessage } from './types.js';
-export type HelpMessageKey = 'cli.help.observe' | 'cli.help.observe_ingest' | 'cli.help.observe_inbox' | 'cli.help.observe_show' | 'cli.help.evolve' | 'cli.help.sample' | 'cli.help.studio';
+export type HelpMessageKey = 'cli.help.observe';
 export declare const helpDict: Record<HelpMessageKey, CliMessage>;