oh-my-knowledge 0.48.0 → 0.49.0

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

@@ -27,12 +27,12 @@ export default class Evolve extends BaseCommand {
         rounds: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         target: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         samples: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        model: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'judge-models': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        'improve-model': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        model: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'judge-models': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        'improve-model': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         concurrency: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         timeout: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        executor: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        executor: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'skip-connectivity': import("@oclif/core/interfaces").BooleanFlag<boolean>;
         effort: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'no-diagnostic': import("@oclif/core/interfaces").BooleanFlag<boolean>;

package/dist/cli/commands/evolve.js

@@ -7,6 +7,8 @@ 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';
+import { formatSampleGenerationFailureHint } from '../lib/generation-failure-hint.js';
+import { envJudgeModels, resolveRuntimeSelection } from '../lib/runtime-defaults.js';
 /** 受管联动旁路:evolve 写回 source 后记证据 + re-baseline。任何异常都不该让 evolve 失败,
  *  故 try/catch 吞掉、返回 null(同 eval 的 recordEvidenceSafely 口径)。 */
 async function recordEvolveOutcomeSafely(input) {
@@ -163,7 +165,10 @@ export async function runEvolve(args, flags, lang) {
         catch (err) {
             if (err instanceof CliExit)
                 throw err;
-            console.error(tCli('cli.common.error_prefix', lang, { message: err.message }));
+            const message = err.message;
+            console.error(tCli('cli.common.error_prefix', lang, {
+                message: `${message}${formatSampleGenerationFailureHint(message, flags.executor, lang)}`,
+            }));
             throw new CliExit(1);
         }
     }
@@ -346,24 +351,21 @@ export default class Evolve extends BaseCommand {
         }),
         model: Flags.string({
             description: bilingual({
-                zh: '被评测的 LLM，默认 sonnet。无用例时也用作自动生成用例的出题模型。',
-                en: 'Evaluated LLM, default sonnet. Also used as the sample-generation model when no samples exist.',
+                zh: '被评测的 LLM。Codex 自动读取本机配置；无用例时也用作自动生成用例的出题模型。',
+                en: 'Evaluated LLM. Codex reads the local configured model. Also used to generate samples when none exist.',
             }),
-            default: 'sonnet',
         }),
         'judge-models': Flags.string({
             description: bilingual({
-                zh: '评委 model（单评委约束），格式 executor:model。默认 claude:haiku',
-                en: 'Judge model (single judge required), executor:model format. Default claude:haiku',
+                zh: '评委 model（单评委约束），格式 executor:model。默认跟随所选执行器；Codex 沿用被测模型。',
+                en: 'Judge model (single judge required), executor:model format. Defaults to the selected executor; Codex reuses the evaluated model.',
             }),
-            default: 'claude:haiku',
         }),
         'improve-model': Flags.string({
             description: bilingual({
-                zh: '负责重写 skill 的 LLM，默认 sonnet',
-                en: 'LLM that rewrites the skill, default sonnet',
+                zh: '负责重写 skill 的 LLM，默认沿用被测模型',
+                en: 'LLM that rewrites the skill; defaults to the evaluated model',
             }),
-            default: 'sonnet',
         }),
         concurrency: Flags.string({
             description: bilingual({ zh: '评测并发数，默认 1', en: 'Eval concurrency, default 1' }),
@@ -376,8 +378,10 @@ export default class Evolve extends BaseCommand {
             parse: numberStringParser('--timeout', { min: 1 }),
         }),
         executor: Flags.string({
-            description: bilingual({ zh: '执行器名，默认 claude', en: 'Executor name, default claude' }),
-            default: 'claude',
+            description: bilingual({
+                zh: '执行器名。Codex 任务内自动用 codex；也可用 OMK_EXECUTOR 设置环境偏好。',
+                en: 'Executor name. Defaults to codex inside Codex tasks; OMK_EXECUTOR sets an environment preference.',
+            }),
         }),
         'skip-connectivity': Flags.boolean({
             description: bilingual({
@@ -509,7 +513,17 @@ export default class Evolve extends BaseCommand {
         const { args, flags } = await this.parse(Evolve);
         const lang = this.lang;
         await this.runWithCliExit(async () => {
-            await runEvolve(args, { ...flags, lang }, lang);
+            const runtime = resolveRuntimeSelection({ executor: flags.executor, model: flags.model }, { lang });
+            await runEvolve(args, {
+                ...flags,
+                executor: runtime.executor,
+                model: runtime.model,
+                'judge-models': flags['judge-models']
+                    ?? envJudgeModels()
+                    ?? `${runtime.executor}:${runtime.judgeModel}`,
+                'improve-model': flags['improve-model'] ?? runtime.model,
+                lang,
+            }, lang);
         });
     }
 }

package/dist/cli/commands/init.js

@@ -1,8 +1,9 @@
-import { resolve, join } from 'node:path';
+import { resolve, join, relative, sep } from 'node:path';
 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';
+import { shellQuoteArg } from '../../shared/shell-quote.js';
 // 预置 .omk/.gitignore:测量 bulk + doctor --fix 备份(项目本地、不该入库)默认不入库;
 // managed/ 治理档案 + 配置不在此列,默认 track。
 const INIT_OMK_GITIGNORE = `# omk 测量 bulk + doctor --fix 备份(项目本地)——不入库;前导 / 锚定 .omk/ 顶层,不误伤嵌套同名目录。
@@ -94,6 +95,17 @@ description: 多维度代码审查,覆盖安全 / 健壮 / 可维护 / 性能,
 
 对每个维度给出具体的改进建议，并标注严重程度（高/中/低）。
 `;
+const INIT_EVAL_COMMAND = 'omk eval --control code-review-v1 --treatment code-review-v2';
+function isOutsideCwd(relPath) {
+    return relPath === '..' || relPath.startsWith(`..${sep}`);
+}
+function nextEvalCommand(targetDir) {
+    const rel = relative(resolve('.'), targetDir);
+    if (!rel)
+        return INIT_EVAL_COMMAND;
+    const cdTarget = isOutsideCwd(rel) ? targetDir : rel;
+    return `cd ${shellQuoteArg(cdTarget)} && ${INIT_EVAL_COMMAND}`;
+}
 export default class Init extends BaseCommand {
     static description = bilingual({
         zh: '初始化一个 omk 项目：在目标目录铺好待测知识载体（skills/）与评测用例（eval-samples.json），供 omk eval / doctor / evolve / observe / list 操作。默认是两版 code-review skill 的 A/B 起步模板。',
@@ -158,10 +170,11 @@ export default class Init extends BaseCommand {
             console.log(tCli('cli.init.scaffolded', lang, { dir: targetDir }));
             console.log('');
             console.log(tCli('cli.init.next_steps_title', lang));
-            console.log(tCli('cli.init.next_step_run', lang));
+            console.log(tCli('cli.init.next_step_run', lang, { command: nextEvalCommand(targetDir) }));
             console.log(tCli('cli.init.next_step_executor', lang));
+            console.log(tCli('cli.init.next_step_report', lang));
             console.log(tCli('cli.init.next_step_customize', lang));
-            console.log(tCli('cli.init.note_codex_executor', lang));
+            console.log(tCli('cli.init.note_skill_injection', lang));
         });
     }
 }

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

@@ -3,21 +3,20 @@ import { Flags } from '@oclif/core';
 import { BaseCommand } from '../../oclif/base-command.js';
 import { LANG_FLAG, bilingual } from '../../oclif/i18n.js';
 import { integerStringParser } from '../../oclif/parsers.js';
+import { resolveRuntimeSelection } from '../../lib/runtime-defaults.js';
 import { shellQuoteArg } from '../../../shared/shell-quote.js';
+import { ownRecordValue } from '../../../shared/record-count.js';
 function pickSkillCount(value, skillName) {
-    if (!value || value[skillName] == null)
-        return undefined;
-    return { [skillName]: value[skillName] };
+    const selected = value ? ownRecordValue(value, skillName) : undefined;
+    return selected == null ? undefined : { [skillName]: selected };
 }
 function pickSkillString(value, skillName) {
-    if (!value || value[skillName] == null)
-        return undefined;
-    return { [skillName]: value[skillName] };
+    const selected = value ? ownRecordValue(value, skillName) : undefined;
+    return selected == null ? undefined : { [skillName]: selected };
 }
 function pickSkillToolCounts(value, skillName) {
-    if (!value || value[skillName] == null)
-        return undefined;
-    return { [skillName]: value[skillName] };
+    const selected = value ? ownRecordValue(value, skillName) : undefined;
+    return selected == null ? undefined : { [skillName]: selected };
 }
 // runObserveInbox export:test/cli/observe.test.ts in-process import 验证 by-skill 聚合行为。
 export async function runObserveInbox(_args, flags, lang) {
@@ -28,19 +27,29 @@ export async function runObserveInbox(_args, flags, lang) {
         : (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');
+        const { extractSkillSoftStandards } = await import('../../../observability/soft-standards/index.js');
         const view = buildObservationInboxViewModel(dir, { skill: flags.skill });
         const candidates = Object.values(view.skillChains)
             .map((chain) => ({ chain, runtimeEvidence: buildLlmEnhancedRuntimeEvidence(view, chain.skillName) }))
             .filter(({ runtimeEvidence }) => hasLlmEnhancedRuntimeEvidence(runtimeEvidence));
+        if (candidates.length === 0) {
+            if (flags.json) {
+                console.log(JSON.stringify({ kind: 'observe-llm-enhanced-review', records: [] }, null, 2));
+            }
+            else {
+                console.log(lang === 'zh' ? '没有可用于 LLM 增强复盘的运行证据' : 'No runtime evidence is available for LLM enhanced review');
+            }
+            return;
+        }
+        const runtime = resolveRuntimeSelection({ executor: flags.executor, model: flags.model }, { lang });
         const records = [];
         for (const { chain, runtimeEvidence } of candidates) {
             records.push(await extractSkillSoftStandards({
                 observationsDir: dir,
                 skillChain: chain,
                 runtimeEvidence,
-                model: flags.model || DEFAULT_LLM_ENHANCED_REVIEW_MODEL,
-                executorName: flags.executor,
+                model: runtime.model,
+                executorName: runtime.executor,
                 refresh: flags.refresh,
             }));
         }
@@ -48,10 +57,6 @@ export async function runObserveInbox(_args, flags, lang) {
             console.log(JSON.stringify({ kind: 'observe-llm-enhanced-review', records }, null, 2));
             return;
         }
-        if (records.length === 0) {
-            console.log(lang === 'zh' ? '没有可用于 LLM 增强复盘的运行证据' : 'No runtime evidence is available for LLM enhanced review');
-            return;
-        }
         console.log(lang === 'zh' ? 'LLM 增强复盘已生成:' : 'LLM enhanced review generated:');
         for (const record of records) {
             console.log(`- ${record.skillName} standards=${record.standards.length} model=${record.model} prompt=${record.promptId}/${record.promptVersion}`);
@@ -120,8 +125,10 @@ export async function runObserveInbox(_args, flags, lang) {
     for (const item of items) {
         const evidence = item.evidence.query || item.evidence.path || item.evidence.assistantSnippet || item.evidence.outputSnippet || '';
         const artifactVersion = item.artifactVersion === 'unknown' ? '⚠ unknown' : item.artifactVersion;
+        const timestampedOccurrences = item.timestampedOccurrences
+            ?? (item.firstSeen === '1970-01-01T00:00:00.000Z' ? 0 : item.occurrences);
         console.log(`- [${item.severity}] (${item.sourceKind}) ${item.skillName} ${item.signalType}/${item.signalSubtype} x${item.occurrences} confidence=${item.confidence.toFixed(2)} attribution=${item.attributionConfidence.toFixed(2)}`);
-        console.log(`  lastSeen=${item.lastSeen} version=${artifactVersion}`);
+        console.log(`  lastSeen=${timestampedOccurrences > 0 ? item.lastSeen : 'unknown'} version=${artifactVersion}`);
         console.log(`  reason=${item.severityReasonCode ?? 'unknown'}`);
         if (evidence)
             console.log(`  evidence=${evidence.slice(0, 180)}`);
@@ -260,14 +267,14 @@ export default class ObserveInbox extends BaseCommand {
         }),
         model: Flags.string({
             description: bilingual({
-                zh: 'LLM 增强复盘使用的模型，默认 sonnet',
-                en: 'Model for LLM enhanced review, default sonnet',
+                zh: 'LLM 增强复盘使用的模型。Codex 自动读取本机配置；也可用 OMK_MODEL 设置环境偏好。',
+                en: 'Model for LLM enhanced review. Codex reads the local configured model; OMK_MODEL sets an environment preference.',
             }),
         }),
         executor: Flags.string({
             description: bilingual({
-                zh: 'LLM 增强复盘使用的执行器',
-                en: 'Executor for LLM enhanced review',
+                zh: 'LLM 增强复盘使用的执行器。Codex 任务内自动用 codex；也可用 OMK_EXECUTOR 设置环境偏好。',
+                en: 'Executor for LLM enhanced review. Defaults to codex inside Codex tasks; OMK_EXECUTOR sets an environment preference.',
             }),
         }),
         json: Flags.boolean({

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

@@ -1,4 +1,4 @@
-import { mkdirSync, writeFileSync } from 'node:fs';
+import { mkdirSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { Args, Flags } from '@oclif/core';
 import { LANG_FLAG, bilingual } from '../../oclif/i18n.js';
@@ -10,6 +10,7 @@ import { projectObserveHealthDir, globalObserveHealthDir } from '../../../eval-c
 import { indexObserveWrite } from '../../../eval-core/artifact-index.js';
 import { reportFilePath, runFileSuffix } from '../../../eval-core/artifact-file-names.js';
 import { migrateLegacyReportFiles } from '../../../eval-core/report-file-migration.js';
+import { writeJsonFileAtomic } from '../../../shared/atomic-json.js';
 /**
  * observe-health 报告落盘:id / 文件名加 4 位随机段,根治「同秒两次 omk observe 直接覆盖、数据丢失」的 bug。
  * 文件名统一为 `{run}.report.json`:目录表达 observe-health 域,文件表达这是可读报告。
@@ -20,7 +21,7 @@ export function persistObserveHealthReport(report, outDir) {
     migrateLegacyReportFiles(outDir, 'observe-health');
     const id = runFileSuffix();
     const jsonPath = reportFilePath(outDir, id);
-    writeFileSync(jsonPath, JSON.stringify(report, null, 2));
+    writeJsonFileAtomic(jsonPath, report);
     indexObserveWrite(report, jsonPath, outDir, id);
     return { id, jsonPath };
 }
@@ -90,23 +91,23 @@ async function recordObserveFeedback(report, reportId, lang) {
 // 由 Studio 健康报告页按需渲染。observe 这条线的另一条产物是观测收件箱(observe-inbox)，走子命令 ingest / inbox / show。
 export default class Observe extends BaseCommand {
     static description = bilingual({
-        zh: '分析 sessions 目录的 skill 调用健康度（默认行为）。子命令:ingest / inbox / show。',
-        en: 'Analyze skill invocation health from a sessions dir (default). Subcommands: ingest / inbox / show.',
+        zh: '把 Codex、Claude Code、OpenClaw 或 markdown trace 统一为 Trace IR，分析 skill 调用健康度（默认行为）。子命令：ingest / inbox / show。',
+        en: 'Normalize Codex, Claude Code, OpenClaw, or markdown traces into Trace IR and analyze skill invocation health (default). Subcommands: ingest / inbox / show.',
     });
     static examples = [
         {
             description: bilingual({
-                zh: '分析最近 7 天',
-                en: 'Analyze last 7 days',
+                zh: '分析最近 7 天的 Codex rollout',
+                en: 'Analyze Codex rollouts from the last 7 days',
             }),
-            command: '<%= config.bin %> observe ~/.claude/sessions --last 7d',
+            command: '<%= config.bin %> observe ~/.codex/sessions --last 7d',
         },
     ];
     static args = {
         sessionsDir: Args.string({
             description: bilingual({
-                zh: 'sessions 目录路径（如 ~/.claude/sessions）',
-                en: 'Sessions dir path (e.g. ~/.claude/sessions)',
+                zh: 'sessions 目录路径（如 ~/.codex/sessions 或 ~/.claude/projects/<project>）',
+                en: 'Sessions dir path (e.g. ~/.codex/sessions or ~/.claude/projects/<project>)',
             }),
             required: false,
         }),
@@ -192,9 +193,17 @@ export default class Observe extends BaseCommand {
                 ? resolve(flags['output-dir'])
                 : (flags.global ? globalObserveHealthDir() : projectObserveHealthDir());
             const { id, jsonPath } = persistObserveHealthReport(report, outDir);
-            const { sessionCount, segmentCount, toolCallCount, toolFailureRate } = report.meta;
+            const { traceIngestionNotices } = await import('../../../observability/trace-ingestion.js');
+            for (const notice of traceIngestionNotices(report.meta.ingestion, lang)) {
+                process.stderr.write(`${notice.text}\n`);
+            }
+            const { sessionCount, segmentCount, toolCallCount, toolFailureRate, toolResolvedCount = toolCallCount, toolCancelledCount = 0, toolUnknownCount = 0, } = report.meta;
+            const toolComparableCount = Math.max(0, toolResolvedCount - toolCancelledCount);
+            const failureSummary = toolCallCount > 0 && toolComparableCount === 0
+                ? `fail rate: unavailable${toolCancelledCount > 0 ? ` · cancelled: ${toolCancelledCount}` : ''}${toolUnknownCount > 0 ? ` · unknown outcomes: ${toolUnknownCount}` : ''}`
+                : `fail rate: ${(toolFailureRate * 100).toFixed(1)}% (${toolComparableCount} comparable${toolCancelledCount > 0 ? ` · ${toolCancelledCount} cancelled` : ''})`;
             console.log('');
-            console.log(`sessions: ${sessionCount} · segments: ${segmentCount} · tool calls: ${toolCallCount} · fail rate: ${(toolFailureRate * 100).toFixed(1)}%`);
+            console.log(`sessions: ${sessionCount} · segments: ${segmentCount} · tool calls: ${toolCallCount} · ${failureSummary}`);
             const overallConf = report.overall.confidence;
             const confSuffix = overallConf === 'high'
                 ? ''

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

@@ -1,4 +1,6 @@
 import { BaseCommand } from '../../oclif/base-command.js';
+import type { ObservationInboxReport } from '../../../types/observability.js';
+export declare function formatIngestSummary(report: ObservationInboxReport, lang: 'zh' | 'en'): string;
 export default class ObserveIngest extends BaseCommand {
     static description: string;
     static args: {
@@ -8,6 +10,7 @@ export default class ObserveIngest extends BaseCommand {
         lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         'output-dir': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         global: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

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

@@ -4,6 +4,21 @@ import { BaseCommand } from '../../oclif/base-command.js';
 import { LANG_FLAG, bilingual } from '../../oclif/i18n.js';
 import { CliExit } from '../../lib/cli-exit.js';
 import { shellQuoteArg } from '../../../shared/shell-quote.js';
+export function formatIngestSummary(report, lang) {
+    const severityCounts = {
+        high: 0,
+        medium: 0,
+        low: 0,
+        noise: 0,
+    };
+    for (const item of report.items)
+        severityCounts[item.severity]++;
+    const sessions = report.meta.sessionCount ?? 0;
+    if (lang === 'zh') {
+        return `observe inbox：会话 ${sessions} · 片段 ${report.meta.segmentCount} · 信号 ${report.meta.itemCount}（高 ${severityCounts.high} / 中 ${severityCounts.medium} / 低 ${severityCounts.low} / 噪声 ${severityCounts.noise}）`;
+    }
+    return `observe inbox: ${sessions} sessions · ${report.meta.segmentCount} segments · ${report.meta.itemCount} signals (high ${severityCounts.high} / medium ${severityCounts.medium} / low ${severityCounts.low} / noise ${severityCounts.noise})`;
+}
 export default class ObserveIngest extends BaseCommand {
     static description = bilingual({
         zh: '把 trace 目录 ingest 成 observation inbox 报告。',
@@ -33,6 +48,13 @@ export default class ObserveIngest extends BaseCommand {
             }),
             default: false,
         }),
+        json: Flags.boolean({
+            description: bilingual({
+                zh: '把完整 observation inbox 报告输出到 stdout；默认只输出摘要。',
+                en: 'Print the full observation inbox report to stdout; defaults to a concise summary.',
+            }),
+            default: false,
+        }),
     };
     async run() {
         const { args, flags } = await this.parse(ObserveIngest);
@@ -62,7 +84,7 @@ export default class ObserveIngest extends BaseCommand {
                     : 'Error: --output-dir must not be an empty string.');
                 throw new CliExit(2);
             }
-            const { buildObservationInboxReport, saveObservationInboxReport, DEFAULT_PROJECT_OBSERVATIONS_DIR, DEFAULT_GLOBAL_OBSERVATIONS_DIR } = await import('../../../observability/inbox.js');
+            const { buildObservationInboxReport, compactObservationInboxReport, saveObservationInboxReport, DEFAULT_PROJECT_OBSERVATIONS_DIR, DEFAULT_GLOBAL_OBSERVATIONS_DIR, } = await import('../../../observability/inbox.js');
             // 显式 --output-dir 最高;否则 --global 写全局、默认写项目(读侧 loadObservationInboxReports 会从项目兜底到全局)。
             const defaultDir = flags.global ? DEFAULT_GLOBAL_OBSERVATIONS_DIR : DEFAULT_PROJECT_OBSERVATIONS_DIR;
             const outDir = resolve(outDirRaw ?? defaultDir);
@@ -71,7 +93,13 @@ export default class ObserveIngest extends BaseCommand {
             const report = buildObservationInboxReport(tracePath, { reviewState: loadObservationReviewState(outDir) });
             report.diagnostics = buildObserveDiagnosticsFromReport(report);
             const path = saveObservationInboxReport(report, outDir);
-            console.log(JSON.stringify(report, null, 2));
+            console.log(flags.json
+                ? JSON.stringify(compactObservationInboxReport(report), null, 2)
+                : formatIngestSummary(report, lang));
+            const { traceIngestionNotices } = await import('../../../observability/trace-ingestion.js');
+            for (const notice of traceIngestionNotices(report.meta.ingestion, lang)) {
+                process.stderr.write(`${notice.text}\n`);
+            }
             const inboxCommand = `omk observe inbox --input-dir ${shellQuoteArg(outDir)}`;
             const sampleCommand = `omk sample --from-traces --observations-dir ${shellQuoteArg(outDir)}`;
             process.stderr.write(lang === 'zh'

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

@@ -1,8 +1,10 @@
 import { BaseCommand } from '../oclif/base-command.js';
 import { type CliLang } from '../lib/i18n.js';
-import { type LoadSamplesResult } from '../../inputs/load-samples.js';
+import { writeFixedSamplesToSources } from '../../inputs/sample-document.js';
 import type { SampleFlags } from '../lib/cmd-flags.js';
 import type { Report, Sample as SampleType } from '../../types/index.js';
+import type { ResolvedSkillInput } from '../lib/resolve-skill-input.js';
+export declare function sampleNextEvalCommand(resolved: Pick<ResolvedSkillInput, 'isDirectorySkill' | 'skillDir' | 'skillPath'>): string;
 /** --append 合并:已有用例原样保留,新用例逐条接在后面;sample_id 撞已有(或本批已用)时
  *  自动加 `-2`/`-3` 后缀去重。模型每次从 s001 重编号,撞 id 不代表内容重复,所以是改名保留
  *  而非丢弃(不做内容级去重)。`reserved` 为额外要避开的 id 集(目录模式跨同目录其它 sample
@@ -21,10 +23,11 @@ export declare function assertFixReportMatchesCurrentInputs(params: {
     treatmentName: string;
     currentContentHash: string;
     samples: SampleType[];
+    samplesBaseDir?: string;
     sampleIds: Set<string>;
     lang?: CliLang;
 }): void;
-export declare function writeFixedSamplesToSources(loaded: Pick<LoadSamplesResult, 'sourceFiles' | 'sampleSourceById'>, samples: SampleType[], changedIds: Set<string>): string[];
+export { writeFixedSamplesToSources };
 export declare function runSampleFromTraces(flags: SampleFlags, lang: CliLang): Promise<void>;
 export default class Sample extends BaseCommand {
     static description: string;
@@ -39,7 +42,7 @@ export default class Sample extends BaseCommand {
         lang: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         batch: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         count: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        model: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        model: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         executor: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         'skill-dir': import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         focus: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;