oh-my-knowledge 0.26.0 → 0.27.0

package/dist/src/cli/commands/improve-skill.js

@@ -0,0 +1,115 @@
+import { CliExit } from '../cli-exit.js';
+import { resolve, join } from 'node:path';
+import { existsSync } from 'node:fs';
+import { tCli, langFromArgv } from '../i18n.js';
+import { COMMON_OPTIONS } from '../parse-run-config.js';
+import { parseArgsStrictOrExit } from '../parse-strict.js';
+import { makeOnProgress } from '../progress.js';
+export async function execute(argv) {
+    const lang = langFromArgv(argv);
+    const { values, positionals } = parseArgsStrictOrExit({
+        args: argv,
+        options: {
+            ...COMMON_OPTIONS,
+            rounds: { type: 'string', default: '5' },
+            target: { type: 'string' },
+            samples: { type: 'string', default: 'eval-samples.json' },
+            model: { type: 'string', default: 'sonnet' },
+            'judge-models': { type: 'string', default: 'claude:haiku' },
+            'improve-model': { type: 'string', default: 'sonnet' },
+            concurrency: { type: 'string', default: '1' },
+            timeout: { type: 'string', default: '120' },
+            executor: { type: 'string', default: 'claude' },
+            'skip-connectivity': { type: 'boolean', default: false },
+        },
+        allowPositionals: true,
+    });
+    // skill path 走 parseArgs 的 positionals，避免 raw argv.find 把 flag value
+    // 当成 path 误识别，例如 `improve skill --judge-models openai-api:gpt-4o foo.md`。
+    const skillPath = positionals[0];
+    if (!skillPath) {
+        console.error(tCli('cli.evolve.specify_skill_path', lang));
+        throw new CliExit(1);
+    }
+    let samplesFile = values.samples ?? 'eval-samples.json';
+    if (samplesFile === 'eval-samples.json' && !existsSync(resolve(samplesFile))) {
+        if (existsSync(resolve('eval-samples.yaml')))
+            samplesFile = 'eval-samples.yaml';
+        else if (existsSync(resolve('eval-samples.yml')))
+            samplesFile = 'eval-samples.yml';
+    }
+    const { evolveSkill } = await import('../../authoring/evolver.js');
+    const { parseJudgeModelsArgOrExit } = await import('../parse-run-config.js');
+    const evolveJudges = parseJudgeModelsArgOrExit(values['judge-models']);
+    if (evolveJudges.length > 1) {
+        console.error(tCli('cli.common.judge_models_single_only', lang, { cmd: 'improve skill' }));
+        throw new CliExit(2);
+    }
+    process.stderr.write(tCli('cli.evolve.section_header', lang, { path: skillPath }));
+    try {
+        const result = await evolveSkill({
+            skillPath: resolve(skillPath),
+            samplesPath: resolve(samplesFile),
+            rounds: Math.max(1, Number(values.rounds) || 5),
+            target: values.target ? Number(values.target) : null,
+            model: values.model,
+            judgeModels: evolveJudges,
+            improveModel: values['improve-model'],
+            executorName: values.executor,
+            concurrency: Math.max(1, Number(values.concurrency) || 1),
+            timeoutMs: Math.max(1, Number(values.timeout) || 120) * 1000,
+            skipConnectivity: values['skip-connectivity'],
+            onProgress: makeOnProgress(lang),
+            onRoundProgress({ round, totalRounds: _totalRounds, phase, score, delta, accepted, costUSD, costReported, error }) {
+                // costReported=false 时显示「—」而不是 $0.0000(executor 不报 cost,如 codex)。
+                // 缺位 / true 当 reported 走旧格式。
+                const fmtRoundCost = (c, r) => r ? `$${c.toFixed(4)}` : '—';
+                if (phase === 'baseline') {
+                    process.stderr.write(tCli('cli.evolve.round_baseline', lang, {
+                        score: score.toFixed(2), cost: fmtRoundCost(costUSD, costReported !== false),
+                    }));
+                }
+                else if (phase === 'error') {
+                    process.stderr.write(tCli('cli.evolve.round_error', lang, {
+                        round, error: String(error ?? ''),
+                    }));
+                }
+                else if (phase === 'done') {
+                    const delta_ = delta >= 0 ? `+${delta.toFixed(2)}` : delta.toFixed(2);
+                    const status = accepted ? '✓ ACCEPT' : '✗ REJECT';
+                    process.stderr.write(tCli('cli.evolve.round_done', lang, {
+                        round, score: score.toFixed(2), delta: delta_, status, cost: fmtRoundCost(costUSD, costReported !== false),
+                    }));
+                }
+            },
+        });
+        const improvement = result.startScore > 0
+            ? ((result.finalScore - result.startScore) / result.startScore * 100).toFixed(1)
+            : '0';
+        const totalCostStr = result.costReported === false
+            ? '—' // 任一轮的 executor 不报 cost → totalCostUSD 是 lower-bound
+            : `$${result.totalCostUSD.toFixed(4)}`;
+        process.stderr.write(tCli('cli.evolve.summary', lang, {
+            start: result.startScore.toFixed(2), final: result.finalScore.toFixed(2),
+            percent: improvement, rounds: result.totalRounds, cost: totalCostStr,
+        }));
+        process.stderr.write(tCli('cli.evolve.best_path', lang, {
+            best: result.bestSkillPath, target: resolve(skillPath),
+        }));
+        process.stderr.write(tCli('cli.evolve.versions_saved', lang, {
+            dir: join(resolve(skillPath, '..'), 'evolve'),
+        }));
+        if (result.reportId) {
+            process.stderr.write(tCli('cli.evolve.report_link', lang, { id: result.reportId }));
+        }
+        console.log(JSON.stringify(result, null, 2));
+    }
+    catch (err) {
+        // CliExit 是显式 exit 信号,保持原 code 透传(同 gate / run)。
+        if (err instanceof CliExit)
+            throw err;
+        console.error(tCli('cli.common.error_prefix', lang, { message: err.message }));
+        throw new CliExit(1);
+    }
+}
+//# sourceMappingURL=improve-skill.js.map

package/dist/src/cli/commands/improve-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve-skill.js","sourceRoot":"","sources":["../../../../src/cli/commands/improve-skill.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/commands/improve.d.ts

@@ -0,0 +1,2 @@
+export declare function execute(argv: string[]): Promise<void>;
+//# sourceMappingURL=improve.d.ts.map

package/dist/src/cli/commands/improve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/improve.ts"],"names":[],"mappings":"AAOA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC3D"}

package/dist/src/cli/commands/improve.js

@@ -0,0 +1,34 @@
+import { CliExit } from '../cli-exit.js';
+import { tCli, langFromArgv } from '../i18n.js';
+import { execute as failures } from './improve-failures.js';
+import { execute as plan } from './improve-plan.js';
+import { execute as samples } from './improve-samples.js';
+import { execute as skill } from './improve-skill.js';
+export async function execute(argv) {
+    const lang = langFromArgv(argv);
+    const [sub, ...rest] = argv;
+    if (!sub) {
+        console.log(tCli('cli.help.improve', lang).trim());
+        throw new CliExit(1);
+    }
+    if (sub === 'samples') {
+        await samples(rest);
+        return;
+    }
+    if (sub === 'skill') {
+        await skill(rest);
+        return;
+    }
+    if (sub === 'plan') {
+        await plan(rest);
+        return;
+    }
+    if (sub === 'failures') {
+        await failures(rest);
+        return;
+    }
+    // Bare `omk improve <report-id>` is the common path: produce a repair plan
+    // from the finished report without forcing users to remember `plan`.
+    await plan([sub, ...rest]);
+}
+//# sourceMappingURL=improve.js.map

package/dist/src/cli/commands/improve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"improve.js","sourceRoot":"","sources":["../../../../src/cli/commands/improve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEtD,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAc;IAC1C,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC;IAE5B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO;IACT,CAAC;IAED,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;QACpB,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;QAClB,OAAO;IACT,CAAC;IAED,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACnB,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO;IACT,CAAC;IAED,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;QACvB,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,2EAA2E;IAC3E,qEAAqE;IACrE,MAAM,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;AAC7B,CAAC"}

package/dist/src/cli/commands/init.d.ts

@@ -0,0 +1,2 @@
+export declare function execute(argv: string[]): Promise<void>;
+//# sourceMappingURL=init.d.ts.map

package/dist/src/cli/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAsFA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA4B3D"}

package/dist/src/cli/commands/init.js

@@ -0,0 +1,110 @@
+import { resolve, join } from 'node:path';
+import { tCli, langFromArgv } from '../i18n.js';
+import { COMMON_OPTIONS } from '../parse-run-config.js';
+import { parseArgsStrictOrExit } from '../parse-strict.js';
+const INIT_SAMPLES = `[
+  {
+    "sample_id": "s001",
+    "prompt": "审查以下代码",
+    "context": "function authenticate(username, password) {\\n  const query = \`SELECT * FROM users WHERE name='\${username}' AND pass='\${password}'\`;\\n  return db.execute(query);\\n}",
+    "rubric": "应识别 SQL 注入风险，建议使用参数化查询",
+    "assertions": [
+      { "type": "contains", "value": "SQL", "weight": 1 },
+      { "type": "contains", "value": "injection", "weight": 1 },
+      { "type": "regex", "pattern": "parameterized|prepared|placeholder|bind", "flags": "i", "weight": 0.5 },
+      { "type": "not_contains", "value": "looks good", "weight": 0.5 }
+    ],
+    "dimensions": {
+      "security": "是否准确识别出 SQL 注入漏洞并说明其危害",
+      "actionability": "是否给出可直接使用的参数化查询修复代码"
+    }
+  },
+  {
+    "sample_id": "s002",
+    "prompt": "审查以下代码",
+    "context": "async function fetchData(url) {\\n  const res = await fetch(url);\\n  const data = await res.json();\\n  return data;\\n}",
+    "rubric": "应指出缺少错误处理（网络异常、非 JSON 响应、HTTP 错误状态码）",
+    "assertions": [
+      { "type": "contains", "value": "error handling", "weight": 1 },
+      { "type": "regex", "pattern": "try[\\\\s\\\\S]*catch|exception|error", "flags": "i", "weight": 1 },
+      { "type": "contains", "value": "status", "weight": 0.5 }
+    ],
+    "dimensions": {
+      "robustness": "是否指出了所有缺失的错误处理场景",
+      "actionability": "是否给出了完整的 try-catch 修复代码"
+    }
+  },
+  {
+    "sample_id": "s003",
+    "prompt": "审查以下代码",
+    "context": "function renderComment(comment) {\\n  document.getElementById('output').innerHTML = '<p>' + comment + '</p>';\\n}",
+    "rubric": "应识别 XSS 风险，建议使用 textContent 或转义 HTML",
+    "assertions": [
+      { "type": "contains", "value": "XSS", "weight": 1 },
+      { "type": "regex", "pattern": "textContent|escape|sanitize|sanitizer", "flags": "i", "weight": 1 },
+      { "type": "contains", "value": "innerHTML", "weight": 0.5 }
+    ],
+    "dimensions": {
+      "security": "是否准确识别出 XSS 漏洞并说明攻击方式",
+      "actionability": "是否给出使用 textContent 或转义的修复代码"
+    }
+  }
+]
+`;
+// 模板带 Claude Code SKILL.md 兼容 frontmatter(name + description),让用户
+// 可以把 init 出来的 SKILL.md 直接 deploy 到 ~/.claude/skills/ 给 Claude Code 用,
+// 一份文件双向 dogfood(omk 评测 + Claude 部署)。omk 当前不 strip frontmatter,
+// 它会跟着 leak 进 system prompt — 在 model 行为层面是无害噪声,跨 executor 一致。
+const INIT_SKILL_V1 = `---
+name: code-review-v1
+description: 简单代码审查 skill,识别明显问题
+---
+
+# Code review v1
+
+你是一个代码审查助手。请审查用户提供的代码，指出潜在问题。
+`;
+const INIT_SKILL_V2 = `---
+name: code-review-v2
+description: 多维度代码审查,覆盖安全 / 健壮 / 可维护 / 性能,带严重程度标注
+---
+
+# Code review v2
+
+你是一个高级代码审查专家。请从以下维度审查用户提供的代码：
+
+1. 安全性：是否存在注入、XSS、敏感信息泄露等风险
+2. 健壮性：是否有适当的错误处理和边界检查
+3. 可维护性：命名是否清晰、结构是否合理
+4. 性能：是否存在明显的性能瓶颈
+
+对每个维度给出具体的改进建议，并标注严重程度（高/中/低）。
+`;
+export async function execute(argv) {
+    const lang = langFromArgv(argv);
+    // 走 helper 让未知 option fail-fast（e.g. `omk init --bogus`），
+    // 否则 argv[0] 直接当目录名, --bogus / --lang 都会被当成 dir 写文件。
+    const { positionals } = parseArgsStrictOrExit({
+        args: argv,
+        allowPositionals: true,
+        options: { ...COMMON_OPTIONS },
+    });
+    const targetDir = resolve(positionals[0] || '.');
+    const { writeFileSync, mkdirSync } = await import('node:fs');
+    // omk skill loader 把 `skills/<name>/SKILL.md` 子目录识别为 directory-skill,
+    // cwd 默认锚到 skill 根目录,后续可在同目录下放 assets / 子文档。
+    // 子目录主题化命名(code-review-v1 / code-review-v2)比泛 v1.md / v2.md 心智模型更清晰。
+    mkdirSync(join(targetDir, 'skills', 'code-review-v1'), { recursive: true });
+    mkdirSync(join(targetDir, 'skills', 'code-review-v2'), { recursive: true });
+    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);
+    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_edit_samples', lang));
+    console.log(tCli('cli.init.next_step_edit_skills', lang));
+    console.log(tCli('cli.init.next_step_run', lang));
+    console.log(tCli('cli.init.note_codex_executor', lang));
+}
+//# sourceMappingURL=init.js.map

package/dist/src/cli/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDpB,CAAC;AAEF,kEAAkE;AAClE,uEAAuE;AACvE,gEAAgE;AAChE,+DAA+D;AAC/D,MAAM,aAAa,GAAG;;;;;;;;CAQrB,CAAC;AAEF,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;CAerB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAc;IAC1C,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,0DAA0D;IAC1D,qDAAqD;IACrD,MAAM,EAAE,WAAW,EAAE,GAAG,qBAAqB,CAAC;QAC5C,IAAI,EAAE,IAAI;QACV,gBAAgB,EAAE,IAAI;QACtB,OAAO,EAAE,EAAE,GAAG,cAAc,EAAE;KAC/B,CAAC,CAAC;IACH,MAAM,SAAS,GAAW,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC;IACzD,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAE7D,sEAAsE;IACtE,6CAA6C;IAC7C,qEAAqE;IACrE,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5E,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,EAAE,YAAY,CAAC,CAAC;IAClE,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,CAAC,EAAE,aAAa,CAAC,CAAC;IACtF,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,UAAU,CAAC,EAAE,aAAa,CAAC,CAAC;IAEtF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,qBAAqB,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,2BAA2B,EAAE,IAAI,CAAC,CAAC,CAAC;IACrD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,iCAAiC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,gCAAgC,EAAE,IAAI,CAAC,CAAC,CAAC;IAC1D,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC,CAAC;IAClD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,8BAA8B,EAAE,IAAI,CAAC,CAAC,CAAC;AAC1D,CAAC"}

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

@@ -0,0 +1,2 @@
+export declare function execute(argv: string[]): Promise<void>;
+//# sourceMappingURL=observe.d.ts.map

package/dist/src/cli/commands/observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/observe.ts"],"names":[],"mappings":"AAOA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA0E3D"}

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

@@ -0,0 +1,77 @@
+import { CliExit } from '../cli-exit.js';
+import { resolve, join } from 'node:path';
+import { tCli, langFromArgv } from '../i18n.js';
+import { COMMON_OPTIONS } from '../parse-run-config.js';
+import { parseArgsStrictOrExit } from '../parse-strict.js';
+import { parseLastWindow } from './_shared.js';
+export async function execute(argv) {
+    const lang = langFromArgv(argv);
+    const { values: rawValues, positionals } = parseArgsStrictOrExit({
+        args: argv,
+        allowPositionals: true,
+        options: {
+            ...COMMON_OPTIONS,
+            kb: { type: 'string' },
+            last: { type: 'string' },
+            from: { type: 'string' },
+            to: { type: 'string' },
+            skills: { type: 'string' },
+            'output-dir': { type: 'string' },
+        },
+    });
+    // 该 handler options 全是 string-typed (无 boolean), 收紧 cast 让 caller 直接 use values.xxx 当 string 用。
+    const values = rawValues;
+    const dir = positionals[0];
+    if (!dir) {
+        console.error(tCli('cli.help.observe', lang).trim());
+        throw new CliExit(1);
+    }
+    const tracePath = resolve(dir);
+    const { existsSync, mkdirSync, writeFileSync } = await import('node:fs');
+    if (!existsSync(tracePath)) {
+        console.error(`Trace path does not exist: ${tracePath}`);
+        throw new CliExit(1);
+    }
+    // 时间窗: --from/--to 优先, --last fallback
+    let from = values.from;
+    if (!from && values.last) {
+        const inferred = parseLastWindow(values.last);
+        if (!inferred) {
+            console.error(`Invalid --last format: "${values.last}". Expected e.g. "7d" / "24h" / "30m".`);
+            throw new CliExit(1);
+        }
+        from = inferred;
+    }
+    const to = values.to;
+    const skills = values.skills ? values.skills.split(',').map((s) => s.trim()).filter(Boolean) : undefined;
+    console.log(`[omk] analyzing ${tracePath}...`);
+    const { computeSkillHealthReport } = await import('../../observability/skill-health-analyzer.js');
+    const report = computeSkillHealthReport(tracePath, {
+        kbRoot: values.kb ? resolve(values.kb) : undefined,
+        from,
+        to,
+        skills,
+    });
+    // JSON 是主产物；HTML 由 report server 的 /analyses/:id 按需渲染。
+    const outDir = resolve(values['output-dir'] || join(process.env.HOME || '.', '.oh-my-knowledge', 'analyses'));
+    mkdirSync(outDir, { recursive: true });
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+    const jsonPath = join(outDir, `${timestamp}-skill-health.json`);
+    writeFileSync(jsonPath, JSON.stringify(report, null, 2));
+    // 控制台摘要
+    const { sessionCount, segmentCount, toolCallCount, toolFailureRate } = report.meta;
+    console.log('');
+    console.log(`sessions: ${sessionCount} · segments: ${segmentCount} · tool calls: ${toolCallCount} · fail rate: ${(toolFailureRate * 100).toFixed(1)}%`);
+    console.log(`overall: gapRate ${(report.overall.gapRate * 100).toFixed(1)}% · weightedGapRate ${(report.overall.weightedGapRate * 100).toFixed(1)}% · health: ${report.overall.healthBand}`);
+    console.log('');
+    const skillRows = Object.values(report.bySkill)
+        .sort((a, b) => b.segmentCount - a.segmentCount)
+        .slice(0, 10)
+        .map((s) => `  ${s.skillName.padEnd(24)} segs=${String(s.segmentCount).padStart(4)}  gapRate=${String(Math.round(s.gap.gapRate * 100) + '%').padStart(4)}  weighted=${String(Math.round(s.gap.weightedGapRate * 100) + '%').padStart(4)}${s.coverage ? `  cov=${Math.round(s.coverage.fileCoverageRate * 100)}%` : ''}`);
+    console.log('top skills:');
+    console.log(skillRows.join('\n'));
+    console.log('');
+    console.log(`report written to: ${jsonPath}`);
+    console.log(tCli('cli.observe.view_hint', lang));
+}
+//# sourceMappingURL=observe.js.map

package/dist/src/cli/commands/observe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.js","sourceRoot":"","sources":["../../../../src/cli/commands/observe.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/commands/registry.d.ts

@@ -0,0 +1,11 @@
+import type { CliMessageKey } from '../i18n-dict.js';
+export interface CommandModule {
+    /** i18n key,dispatcher 收到 --help / -h 时打印此 key 的内容并 exit 0。 */
+    helpKey: CliMessageKey;
+    /** 二级子命令 help。用于 `omk eval gold --help` 这类产品子路径。 */
+    subHelp?: Record<string, CliMessageKey>;
+    execute: (argv: string[]) => Promise<void>;
+}
+/** 产品级主命令查表。新增对外命令时,在这里加一行就够。 */
+export declare const PRODUCT_COMMANDS: Record<string, CommandModule>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/cli/commands/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AASrD,MAAM,WAAW,aAAa;IAC5B,+DAA+D;IAC/D,OAAO,EAAE,aAAa,CAAC;IACvB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACxC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;AAED,iCAAiC;AACjC,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAgC1D,CAAC"}

package/dist/src/cli/commands/registry.js

@@ -0,0 +1,42 @@
+import { execute as doctor } from './doctor.js';
+import { execute as evalCommand } from './eval.js';
+import { execute as exportCommand } from './export.js';
+import { execute as improve } from './improve.js';
+import { execute as init } from './init.js';
+import { execute as observe } from './observe.js';
+import { execute as studio } from './studio.js';
+/** 产品级主命令查表。新增对外命令时,在这里加一行就够。 */
+export const PRODUCT_COMMANDS = {
+    init: { helpKey: 'cli.help.init_usage', execute: init },
+    doctor: { helpKey: 'cli.help.doctor_usage', execute: doctor },
+    eval: {
+        helpKey: 'cli.help.eval',
+        subHelp: {
+            gold: 'cli.help.eval_gold',
+            debias: 'cli.help.eval_debias',
+        },
+        execute: evalCommand,
+    },
+    observe: { helpKey: 'cli.help.observe', execute: observe },
+    improve: {
+        helpKey: 'cli.help.improve',
+        subHelp: {
+            plan: 'cli.help.improve_plan',
+            failures: 'cli.help.improve_failures',
+            samples: 'cli.help.improve_samples',
+            skill: 'cli.help.improve_skill',
+        },
+        execute: improve,
+    },
+    export: {
+        helpKey: 'cli.help.export',
+        subHelp: {
+            diff: 'cli.help.export_diff',
+            verdict: 'cli.help.export_verdict',
+            saturation: 'cli.help.export_saturation',
+        },
+        execute: exportCommand,
+    },
+    studio: { helpKey: 'cli.help.studio', execute: studio },
+};
+//# sourceMappingURL=registry.js.map

package/dist/src/cli/commands/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../../src/cli/commands/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,aAAa,CAAC;AAUhD,iCAAiC;AACjC,MAAM,CAAC,MAAM,gBAAgB,GAAkC;IAC7D,IAAI,EAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,OAAO,EAAE,IAAI,EAAE;IAC1D,MAAM,EAAG,EAAE,OAAO,EAAE,uBAAuB,EAAE,OAAO,EAAE,MAAM,EAAE;IAC9D,IAAI,EAAK;QACP,OAAO,EAAE,eAAe;QACxB,OAAO,EAAE;YACP,IAAI,EAAE,oBAAoB;YAC1B,MAAM,EAAE,sBAAsB;SAC/B;QACD,OAAO,EAAE,WAAW;KACrB;IACD,OAAO,EAAE,EAAE,OAAO,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE;IAC1D,OAAO,EAAE;QACP,OAAO,EAAE,kBAAkB;QAC3B,OAAO,EAAE;YACP,IAAI,EAAE,uBAAuB;YAC7B,QAAQ,EAAE,2BAA2B;YACrC,OAAO,EAAE,0BAA0B;YACnC,KAAK,EAAE,wBAAwB;SAChC;QACD,OAAO,EAAE,OAAO;KACjB;IACD,MAAM,EAAG;QACP,OAAO,EAAE,iBAAiB;QAC1B,OAAO,EAAE;YACP,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,yBAAyB;YAClC,UAAU,EAAE,4BAA4B;SACzC;QACD,OAAO,EAAE,aAAa;KACvB;IACD,MAAM,EAAG,EAAE,OAAO,EAAE,iBAAiB,EAAG,OAAO,EAAE,MAAM,EAAE;CAC1D,CAAC"}

package/dist/src/cli/commands/studio.d.ts

@@ -0,0 +1,2 @@
+export declare function execute(argv: string[]): Promise<void>;
+//# sourceMappingURL=studio.d.ts.map

package/dist/src/cli/commands/studio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/studio.ts"],"names":[],"mappings":"AA0BA,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqD3D"}

package/dist/src/cli/commands/studio.js

@@ -0,0 +1,76 @@
+import { resolve } from 'node:path';
+import { langFromArgv, tCli } from '../i18n.js';
+import { COMMON_OPTIONS, DEFAULT_REPORTS_DIR } from '../parse-run-config.js';
+import { parseArgsStrictOrExit } from '../parse-strict.js';
+async function openWorkbench(url, lang) {
+    const { execFile } = await import('node:child_process');
+    const { platform } = await import('node:os');
+    const browser = process.env.BROWSER?.trim();
+    if (browser?.toLowerCase() === 'none')
+        return;
+    const os = platform();
+    const command = browser || (os === 'win32' ? 'cmd' : os === 'darwin' ? 'open' : 'xdg-open');
+    const args = os === 'win32' && !browser
+        ? ['/c', 'start', '', url]
+        : [url];
+    execFile(command, args, (err) => {
+        if (!err)
+            return;
+        process.stderr.write(tCli('cli.studio.open_failed', lang, {
+            command,
+            message: err.message,
+        }));
+    });
+}
+export async function execute(argv) {
+    const lang = langFromArgv(argv);
+    const { values } = parseArgsStrictOrExit({
+        args: argv,
+        options: {
+            ...COMMON_OPTIONS,
+            port: { type: 'string', default: '7799' },
+            'reports-dir': { type: 'string', default: DEFAULT_REPORTS_DIR },
+            'analyses-dir': { type: 'string' },
+            'no-open': { type: 'boolean', default: false },
+            dev: { type: 'boolean', default: false },
+        },
+    });
+    if (values.dev && !process.env.__OMK_DEV_CHILD) {
+        const { spawn } = await import('node:child_process');
+        const { fileURLToPath } = await import('node:url');
+        const cliPath = resolve(fileURLToPath(import.meta.url), '..', '..', 'index.js');
+        const watchRoot = resolve(cliPath, '..', '..');
+        const args = [
+            '--watch-path', watchRoot,
+            cliPath,
+            'studio',
+            '--port', values.port,
+            '--reports-dir', values['reports-dir'],
+        ];
+        if (values['analyses-dir']) {
+            args.push('--analyses-dir', values['analyses-dir']);
+        }
+        if (values['no-open']) {
+            args.push('--no-open');
+        }
+        const child = spawn(process.execPath, args, {
+            stdio: 'inherit',
+            env: { ...process.env, __OMK_DEV_CHILD: '1' },
+        });
+        child.on('exit', (code) => process.exit(code || 0));
+        return;
+    }
+    const { createReportServer } = await import('../../server/report-server.js');
+    const server = createReportServer({
+        port: Number(values.port),
+        reportsDir: resolve(values['reports-dir']),
+        ...(values['analyses-dir'] ? { analysesDir: resolve(values['analyses-dir']) } : {}),
+    });
+    const url = await server.start();
+    console.log(tCli('cli.studio.started', lang, { url }));
+    console.log(tCli('cli.studio.stop_hint', lang));
+    if (!values['no-open'] && process.stdout.isTTY) {
+        await openWorkbench(url, lang);
+    }
+}
+//# sourceMappingURL=studio.js.map

package/dist/src/cli/commands/studio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"studio.js","sourceRoot":"","sources":["../../../../src/cli/commands/studio.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,IAAI,EAAgB,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,IAAa;IACrD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;IACxD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;IAC5C,IAAI,OAAO,EAAE,WAAW,EAAE,KAAK,MAAM;QAAE,OAAO;IAE9C,MAAM,EAAE,GAAG,QAAQ,EAAE,CAAC;IACtB,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC5F,MAAM,IAAI,GAAG,EAAE,KAAK,OAAO,IAAI,CAAC,OAAO;QACrC,CAAC,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,CAAC;QAC1B,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACV,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;QAC9B,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,wBAAwB,EAAE,IAAI,EAAE;YACxD,OAAO;YACP,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAc;IAC1C,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,EAAE,GAAG,qBAAqB,CAAC;QACvC,IAAI,EAAE,IAAI;QACV,OAAO,EAAE;YACP,GAAG,cAAc;YACjB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE;YACzC,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,mBAAmB,EAAE;YAC/D,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YAClC,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;YAC9C,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE;SACzC;KACF,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QAC/C,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACrD,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;QAChF,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG;YACX,cAAc,EAAE,SAAS;YACzB,OAAO;YACP,QAAQ;YACR,QAAQ,EAAE,MAAM,CAAC,IAAc;YAC/B,eAAe,EAAE,MAAM,CAAC,aAAa,CAAW;SACjD,CAAC;QACF,IAAI,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,cAAc,CAAW,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACtB,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzB,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE;YAC1C,KAAK,EAAE,SAAS;YAChB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE;SAC9C,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAmB,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;QACnE,OAAO;IACT,CAAC;IAED,MAAM,EAAE,kBAAkB,EAAE,GAAG,MAAM,MAAM,CAAC,+BAA+B,CAAC,CAAC;IAC7E,MAAM,MAAM,GAAiB,kBAAkB,CAAC;QAC9C,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QACzB,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,CAAW,CAAC;QACpD,GAAG,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,CAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9F,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACjC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IACvD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC,CAAC;IAChD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC/C,MAAM,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/src/cli/coverage-renderer.d.ts

@@ -1,5 +1,5 @@
 /**
- * CLI rendering of Sample design science coverage block for `bench diagnose`.
+ * CLI rendering of Sample design science coverage block for `omk improve`.
  *
  * Two data sources:
  *   1. samples (loaded fresh from eval-samples file) — preferred, always up-to-date

package/dist/src/cli/coverage-renderer.js

@@ -1,5 +1,5 @@
 /**
- * CLI rendering of Sample design science coverage block for `bench diagnose`.
+ * CLI rendering of Sample design science coverage block for `omk improve`.
  *
  * Two data sources:
  *   1. samples (loaded fresh from eval-samples file) — preferred, always up-to-date

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

@@ -16,9 +16,9 @@
  * 2. **保留原文的白名单 (产品术语 / 命令 / 文件名)**
  *    以下 token 在两种语言里都保留原文, 不翻译:
  *    - 产品名: omk, oh-my-knowledge, Claude, npm
- *    - 子命令空间和命令名: bench, analyze, run, report, init, evolve, gold,
- *      diff, ci, gen-samples, debias-validate, saturation, verdict,
- *      diagnose, failures
+ *    - 子命令空间和命令名: init, doctor, eval, observe, improve, export,
+ *      studio, samples, skill, plan, failures, gold, debias, diff, verdict,
+ *      saturation
  *    - omk 核心业务术语: skill, variant, sample, judge, executor (出现在产品
  *      UI 里时首字母可大写如 "Skill 评测", 描述句中保持小写)
  *    - 技术参数: --lang, --control, --treatment, --bootstrap, --judge-repeat,
@@ -47,7 +47,7 @@
  * 未来扩 Lang (zh-TW / ja / ko ...): 改 src/types/shared.ts 的 Lang union,
  * Record 类型自动强制每 key 加新语言版本。
  */
-export type CliMessageKey = 'cli.common.lang_invalid_silent' | 'cli.common.help_hint' | 'cli.common.unknown_domain' | 'cli.common.unknown_bench_command' | 'cli.init.scaffolded' | 'cli.init.next_steps_title' | 'cli.init.next_step_edit_samples' | 'cli.init.next_step_edit_skills' | 'cli.init.next_step_run' | 'cli.init.note_codex_executor' | 'cli.update.new_version_available' | 'cli.progress.preflight_starting' | 'cli.progress.sample_retry' | 'cli.progress.sample_error' | 'cli.progress.sample_executing' | 'cli.progress.sample_exec_done' | 'cli.progress.output_preview' | 'cli.progress.judging' | 'cli.progress.judged' | 'cli.progress.skipped' | 'cli.progress.sample_done' | 'cli.progress.sample_failed_done' | 'cli.run.invalid_repeat' | 'cli.run.invalid_judge_repeat' | 'cli.run.no_debias_length_active' | 'cli.run.invalid_bootstrap_samples' | 'cli.run.bootstrap_samples_too_large' | 'cli.run.skill_section' | 'cli.run.run_section' | 'cli.run.batch_complete' | 'cli.run.eval_complete' | 'cli.run.tally' | 'cli.run.report_saved' | 'cli.run.report_server_running' | 'cli.run.report_server_view' | 'cli.run.report_server_stop' | 'cli.run.no_serve_in_non_tty' | 'cli.run.no_serve_view_hint' | 'cli.run.gold_load_failed' | 'cli.run.gold_load_issue' | 'cli.run.contamination_warning' | 'cli.common.error_prefix' | 'cli.analyze.view_in_browser' | 'cli.common.skill_dir_not_found' | 'cli.common.skill_file_not_found' | 'cli.common.report_not_found' | 'cli.common.no_judge_model' | 'cli.common.judge_models_single_only' | 'cli.common.usage_gold_validate' | 'cli.common.warn_load_samples_failed' | 'cli.gen.skill_skipped_existing' | 'cli.gen.skill_generating' | 'cli.gen.skill_done' | 'cli.gen.skill_failed' | 'cli.gen.batch_none_needed' | 'cli.gen.batch_summary' | 'cli.gen.specify_skill_path' | 'cli.gen.samples_already_exists' | 'cli.gen.single_generating' | 'cli.gen.single_done' | 'cli.gen.review_hint' | 'cli.gen.failed' | 'cli.evolve.specify_skill_path' | 'cli.evolve.section_header' | 'cli.evolve.round_baseline' | 'cli.evolve.round_error' | 'cli.evolve.round_done' | 'cli.evolve.summary' | 'cli.evolve.best_path' | 'cli.evolve.versions_saved' | 'cli.evolve.report_link' | 'cli.gold.created_files' | 'cli.gold.next_step_edit_annotations' | 'cli.gold.validate_ok' | 'cli.debias.warn_cost_doubles' | 'cli.saturation.no_data' | 'cli.saturation.verdict_header' | 'cli.saturation.variant_no_trace' | 'cli.saturation.variant_label' | 'cli.saturation.checkpoints' | 'cli.saturation.last_point' | 'cli.saturation.persisted_verdict' | 'cli.saturation.persisted_verdict_saturated' | 'cli.saturation.persisted_verdict_unsaturated' | 'cli.saturation.skipped_too_few_points' | 'cli.help.main' | 'cli.help.diff_usage' | 'cli.help.analyze_usage' | 'cli.help.gold' | 'cli.help.debias_validate' | 'cli.help.saturation' | 'cli.help.verdict' | 'cli.help.diagnose' | 'cli.help.failures' | 'cli.diagnose.coverage_header' | 'cli.diagnose.coverage_unspecified' | 'cli.diagnose.coverage_chars' | 'cli.diagnose.coverage_hint_empty' | 'cli.diagnose.coverage_declared' | 'cli.doctor.rule.skill_readable' | 'cli.doctor.rule.skill_metadata' | 'cli.doctor.rule.dependencies' | 'cli.doctor.rule.samples_contract' | 'cli.doctor.skill_readable.pass' | 'cli.doctor.skill_metadata.pass' | 'cli.doctor.dependencies.pass' | 'cli.doctor.samples_contract.pass' | 'cli.doctor.skill_readable.fail.missing' | 'cli.doctor.skill_readable.fail.empty' | 'cli.doctor.skill_readable.fail.too_short' | 'cli.doctor.skill_readable.hint.missing' | 'cli.doctor.dependencies.hint.tool' | 'cli.doctor.dependencies.hint.file' | 'cli.doctor.dependencies.hint.env' | 'cli.doctor.dependencies.hint.preflight' | 'cli.doctor.dependencies.issue.tool_not_found' | 'cli.doctor.dependencies.issue.file_not_found' | 'cli.doctor.dependencies.issue.env_not_set' | 'cli.doctor.dependencies.issue.preflight_failed' | 'cli.doctor.skill_readable.hint.too_short' | 'cli.doctor.skill_metadata.fail.frontmatter_invalid' | 'cli.doctor.skill_metadata.fail.missing_skillmd' | 'cli.doctor.skill_metadata.hint.frontmatter' | 'cli.doctor.skill_metadata.hint.missing_skillmd' | 'cli.doctor.dependencies.fail' | 'cli.doctor.samples_contract.skipped' | 'cli.doctor.samples_contract.warn.empty' | 'cli.doctor.samples_contract.warn.missing_prompt' | 'cli.doctor.samples_contract.hint' | 'cli.help.doctor_usage' | 'cli.doctor.no_skill_found' | 'cli.doctor.gate_blocked' | 'cli.run.skip_connectivity_warning';
+export type CliMessageKey = 'cli.common.unknown_domain' | 'cli.init.scaffolded' | 'cli.init.next_steps_title' | 'cli.init.next_step_edit_samples' | 'cli.init.next_step_edit_skills' | 'cli.init.next_step_run' | 'cli.init.note_codex_executor' | 'cli.update.new_version_available' | 'cli.progress.preflight_starting' | 'cli.progress.sample_retry' | 'cli.progress.sample_error' | 'cli.progress.sample_executing' | 'cli.progress.sample_exec_done' | 'cli.progress.output_preview' | 'cli.progress.judging' | 'cli.progress.judged' | 'cli.progress.skipped' | 'cli.progress.sample_done' | 'cli.progress.sample_failed_done' | 'cli.run.invalid_repeat' | 'cli.run.invalid_judge_repeat' | 'cli.run.no_debias_length_active' | 'cli.run.invalid_bootstrap_samples' | 'cli.run.bootstrap_samples_too_large' | 'cli.run.power_warning_tiny_n' | 'cli.run.power_warning_small_n' | 'cli.run.power_warning_repeat_one' | 'cli.run.dry_run_no_scores' | 'cli.run.skill_section' | 'cli.run.run_section' | 'cli.run.batch_complete' | 'cli.run.batch_verdict_header' | 'cli.run.batch_child_report_missing' | 'cli.run.eval_complete' | 'cli.run.tally' | 'cli.run.report_saved' | 'cli.run.report_only_gate_skipped' | 'cli.run.report_server_running' | 'cli.run.report_server_view' | 'cli.run.report_server_stop' | 'cli.run.no_serve_in_non_tty' | 'cli.run.no_serve_view_hint' | 'cli.run.gold_load_failed' | 'cli.run.gold_load_issue' | 'cli.run.contamination_warning' | 'cli.common.error_prefix' | 'cli.observe.view_hint' | 'cli.common.skill_dir_not_found' | 'cli.common.skill_file_not_found' | 'cli.common.report_not_found' | 'cli.common.no_judge_model' | 'cli.common.judge_models_single_only' | 'cli.common.warn_load_samples_failed' | 'cli.export.unsupported_format' | 'cli.export.html_done' | 'cli.export.done' | 'cli.studio.started' | 'cli.studio.stop_hint' | 'cli.studio.open_failed' | 'cli.gen.skill_skipped_existing' | 'cli.gen.skill_generating' | 'cli.gen.skill_done' | 'cli.gen.skill_failed' | 'cli.gen.batch_none_needed' | 'cli.gen.batch_summary' | 'cli.gen.specify_skill_path' | 'cli.gen.samples_already_exists' | 'cli.gen.single_generating' | 'cli.gen.single_done' | 'cli.gen.review_hint' | 'cli.gen.failed' | 'cli.evolve.specify_skill_path' | 'cli.evolve.section_header' | 'cli.evolve.round_baseline' | 'cli.evolve.round_error' | 'cli.evolve.round_done' | 'cli.evolve.summary' | 'cli.evolve.best_path' | 'cli.evolve.versions_saved' | 'cli.evolve.report_link' | 'cli.help.product_main' | 'cli.help.init_usage' | 'cli.help.eval' | 'cli.help.eval_gold' | 'cli.help.eval_debias' | 'cli.help.observe' | 'cli.help.improve' | 'cli.help.improve_plan' | 'cli.help.improve_failures' | 'cli.help.improve_samples' | 'cli.help.improve_skill' | 'cli.help.export' | 'cli.help.export_diff' | 'cli.help.export_verdict' | 'cli.help.export_saturation' | 'cli.help.studio' | 'cli.diagnose.coverage_header' | 'cli.diagnose.coverage_unspecified' | 'cli.diagnose.coverage_chars' | 'cli.diagnose.coverage_hint_empty' | 'cli.diagnose.coverage_declared' | 'cli.doctor.rule.skill_readable' | 'cli.doctor.rule.skill_metadata' | 'cli.doctor.rule.dependencies' | 'cli.doctor.rule.samples_contract' | 'cli.doctor.skill_readable.pass' | 'cli.doctor.skill_metadata.pass' | 'cli.doctor.dependencies.pass' | 'cli.doctor.samples_contract.pass' | 'cli.doctor.skill_readable.fail.missing' | 'cli.doctor.skill_readable.fail.empty' | 'cli.doctor.skill_readable.fail.too_short' | 'cli.doctor.skill_readable.hint.missing' | 'cli.doctor.dependencies.hint.tool' | 'cli.doctor.dependencies.hint.file' | 'cli.doctor.dependencies.hint.env' | 'cli.doctor.dependencies.hint.preflight' | 'cli.doctor.dependencies.issue.tool_not_found' | 'cli.doctor.dependencies.issue.file_not_found' | 'cli.doctor.dependencies.issue.env_not_set' | 'cli.doctor.dependencies.issue.preflight_failed' | 'cli.doctor.skill_readable.hint.too_short' | 'cli.doctor.skill_metadata.fail.frontmatter_invalid' | 'cli.doctor.skill_metadata.fail.missing_skillmd' | 'cli.doctor.skill_metadata.hint.frontmatter' | 'cli.doctor.skill_metadata.hint.missing_skillmd' | 'cli.doctor.dependencies.fail' | 'cli.doctor.samples_contract.skipped' | 'cli.doctor.samples_contract.warn.empty' | 'cli.doctor.samples_contract.warn.missing_prompt' | 'cli.doctor.samples_contract.hint' | 'cli.help.doctor_usage' | 'cli.doctor.no_skill_found' | 'cli.doctor.samples_detected' | 'cli.doctor.gate_blocked' | 'cli.run.skip_connectivity_warning';
 export interface CliMessage {
     zh: string;
     en: string;