oh-my-knowledge 0.30.0 → 0.31.0

package/dist/src/cli/{commands/_shared.d.ts → lib/shared.d.ts}

@@ -1,4 +1,4 @@
-import { type CliLang } from '../i18n.js';
+import { type CliLang } from './i18n.js';
 import type { EvaluationReport, ReportDocument } from '../../types/index.js';
 export interface EvalResult {
     report: ReportDocument;
@@ -9,4 +9,4 @@ export interface ReportServer {
 }
 export declare function requireEvaluationReport(report: ReportDocument | null, id: string, lang: CliLang): EvaluationReport;
 export declare function parseLastWindow(spec: string): string | null;
-//# sourceMappingURL=_shared.d.ts.map
+//# sourceMappingURL=shared.d.ts.map

package/dist/src/cli/lib/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/shared.ts"],"names":[],"mappings":"AACA,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE7E,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,cAAc,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9B;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAYlH;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ3D"}

package/dist/src/cli/{commands/_shared.js → lib/shared.js}

@@ -1,5 +1,5 @@
-import { CliExit } from '../cli-exit.js';
-import { tCli } from '../i18n.js';
+import { CliExit } from './cli-exit.js';
+import { tCli } from './i18n.js';
 export function requireEvaluationReport(report, id, lang) {
     if (!report) {
         console.error(tCli('cli.common.report_not_found', lang, { id }));
@@ -23,4 +23,4 @@ export function parseLastWindow(spec) {
     const ms = unit === 'd' ? n * 86400_000 : unit === 'h' ? n * 3600_000 : n * 60_000;
     return new Date(Date.now() - ms).toISOString();
 }
-//# sourceMappingURL=_shared.js.map
+//# sourceMappingURL=shared.js.map

package/dist/src/cli/lib/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../../src/cli/lib/shared.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,IAAI,EAAgB,MAAM,WAAW,CAAC;AAY/C,MAAM,UAAU,uBAAuB,CAAC,MAA6B,EAAE,EAAU,EAAE,IAAa;IAC9F,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,6BAA6B,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC;QACjE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACvC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI;YACzB,CAAC,CAAC,MAAM,EAAE,0EAA0E;YACpF,CAAC,CAAC,UAAU,EAAE,8GAA8G,CAAC,CAAC;QAChI,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,2DAA2D;IAC3D,MAAM,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAClB,MAAM,EAAE,GAAG,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC;IACnF,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACjD,CAAC"}

package/dist/src/cli/lib/update-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/update-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,WAAW,CAAC;AAE/C,wBAAsB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B9D"}

package/dist/src/cli/lib/update-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../../../../src/cli/lib/update-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgB,MAAM,WAAW,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAa;IAC7C,IAAI,CAAC;QACH,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAC7D,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;QACnD,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QACpD,MAAM,SAAS,GAAW,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAClE,kDAAkD;QAClD,+DAA+D;QAC/D,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAiB,EAAE;YAC1D,IAAI,GAAG,GAAG,QAAQ,CAAC;YACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC3B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;gBAC5C,IAAI,UAAU,CAAC,SAAS,CAAC;oBAAE,OAAO,SAAS,CAAC;gBAC5C,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YACrB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO;YAAE,OAAO;QACrB,MAAM,GAAG,GACP,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;QAC7C,MAAM,QAAQ,GAAW,GAAG,CAAC,aAAa,EAAE,QAAQ,IAAI,4BAA4B,CAAC;QACrF,MAAM,GAAG,GAAa,MAAM,KAAK,CAAC,GAAG,QAAQ,IAAI,GAAG,CAAC,IAAI,SAAS,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC3G,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO;QACpB,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAA0B,CAAC;QACtD,IAAI,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC;YACjD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,kCAAkC,EAAE,IAAI,EAAE;gBAClE,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI;aACnD,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;IAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;AAChC,CAAC"}

package/dist/src/cli/oclif/base-command.d.ts

@@ -0,0 +1,8 @@
+import { Command } from '@oclif/core';
+import { type Lang } from './i18n.js';
+export declare abstract class BaseCommand extends Command {
+    #private;
+    protected get lang(): Lang;
+    protected runWithCliExit(fn: () => Promise<void>): Promise<void>;
+}
+//# sourceMappingURL=base-command.d.ts.map

package/dist/src/cli/oclif/base-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../../../../src/cli/oclif/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,OAAO,EAAe,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAInD,8BAAsB,WAAY,SAAQ,OAAO;;IAG/C,SAAS,KAAK,IAAI,IAAI,IAAI,CAGzB;cAEe,cAAc,CAAC,EAAE,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;CAYvE"}

package/dist/src/cli/oclif/base-command.js

@@ -0,0 +1,27 @@
+import { Command } from '@oclif/core';
+import { CliExit } from '../lib/cli-exit.js';
+import { resolveLang } from './i18n.js';
+// Shared oclif boundary: command bodies may throw CliExit, and process.argv is
+// stable for one CLI invocation, so language resolution is cached per command.
+export class BaseCommand extends Command {
+    #lang;
+    get lang() {
+        this.#lang ??= resolveLang(process.argv);
+        return this.#lang;
+    }
+    async runWithCliExit(fn) {
+        try {
+            await fn();
+        }
+        catch (err) {
+            if (err instanceof CliExit) {
+                if (err.code === 0)
+                    return;
+                this.exit(err.code);
+                return;
+            }
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=base-command.js.map

package/dist/src/cli/oclif/base-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-command.js","sourceRoot":"","sources":["../../../../src/cli/oclif/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAa,MAAM,WAAW,CAAC;AAEnD,+EAA+E;AAC/E,+EAA+E;AAC/E,MAAM,OAAgB,WAAY,SAAQ,OAAO;IAC/C,KAAK,CAAQ;IAEb,IAAc,IAAI;QAChB,IAAI,CAAC,KAAK,KAAK,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAES,KAAK,CAAC,cAAc,CAAC,EAAuB;QACpD,IAAI,CAAC;YACH,MAAM,EAAE,EAAE,CAAC;QACb,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,OAAO,EAAE,CAAC;gBAC3B,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC;oBAAE,OAAO;gBAC3B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBACpB,OAAO;YACT,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/src/cli/oclif/help.d.ts

@@ -0,0 +1,16 @@
+import { Command, Help } from '@oclif/core';
+export default class LangAwareHelp extends Help {
+    private get lang();
+    formatCommand(command: Command.Loadable): string;
+    formatCommands(commands: Command.Loadable[]): string;
+    showCommandHelp(command: Command.Loadable): Promise<void>;
+    showTopicHelp(topic: {
+        name: string;
+        description?: string;
+    }): Promise<void>;
+    formatTopics(topics: Array<{
+        name: string;
+        description?: string;
+    }>): string;
+}
+//# sourceMappingURL=help.d.ts.map

package/dist/src/cli/oclif/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../../src/cli/oclif/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAc5C,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,IAAI;IAC7C,OAAO,KAAK,IAAI,GAEf;IAED,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,GAAG,MAAM;IAIhD,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,GAAG,MAAM;IAI9C,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzD,aAAa,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjF,YAAY,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,MAAM;CAG5E"}

package/dist/src/cli/oclif/help.js

@@ -0,0 +1,33 @@
+import { Help } from '@oclif/core';
+import { resolveLang } from './i18n.js';
+import { projectCommand, projectTopic } from './projection.js';
+// LangAwareHelp:oclif Help 子类,按 --lang / OMK_LANG 切 description / flags
+// 的双语 sentinel 到单语再交给 super 渲染。`--help` 路径(formatCommand /
+// showCommandHelp / formatTopics)都走 projectCommand 投影成单语。
+//
+// 已知盲区:oclif `errors/handle.js:L44` 硬编码 `new Help(config)` 不走 helpClass,
+// parse error 时 dump 出来的 FLAGS / USAGE 拿到的是原 `${zh}\n${en}` 双语 sentinel,
+// LangAwareHelp 没机会拦,用户会看到双语并列。这是已知 UX 限制(Phase B 评估能否
+// fork @oclif/core 修)。lang 解析跟业务侧 `resolveLang(process.argv)` 一致,
+// 优先级 `--lang CLI flag > OMK_LANG env > zh`。
+export default class LangAwareHelp extends Help {
+    get lang() {
+        return resolveLang(process.argv);
+    }
+    formatCommand(command) {
+        return super.formatCommand(projectCommand(command, this.lang));
+    }
+    formatCommands(commands) {
+        return super.formatCommands(commands.map((c) => projectCommand(c, this.lang)));
+    }
+    async showCommandHelp(command) {
+        return super.showCommandHelp(projectCommand(command, this.lang));
+    }
+    async showTopicHelp(topic) {
+        return super.showTopicHelp(projectTopic(topic, this.lang));
+    }
+    formatTopics(topics) {
+        return super.formatTopics(topics.map((t) => projectTopic(t, this.lang)));
+    }
+}
+//# sourceMappingURL=help.js.map

package/dist/src/cli/oclif/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../../../src/cli/oclif/help.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,IAAI,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAa,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAE/D,wEAAwE;AACxE,2DAA2D;AAC3D,0DAA0D;AAC1D,EAAE;AACF,yEAAyE;AACzE,yEAAyE;AACzE,uDAAuD;AACvD,kEAAkE;AAClE,6CAA6C;AAE7C,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,IAAI;IAC7C,IAAY,IAAI;QACd,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,aAAa,CAAC,OAAyB;QACrC,OAAO,KAAK,CAAC,aAAa,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,CAAC;IAED,cAAc,CAAC,QAA4B;QACzC,OAAO,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,OAAyB;QAC7C,OAAO,KAAK,CAAC,eAAe,CAAC,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,KAA6C;QAC/D,OAAO,KAAK,CAAC,aAAa,CAAC,YAAY,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,CAAC;IAED,YAAY,CAAC,MAAqD;QAChE,OAAO,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3E,CAAC;CACF"}

package/dist/src/cli/oclif/i18n.d.ts

@@ -0,0 +1,16 @@
+import { getCliLang, parseLangFromArgv } from '../lib/i18n.js';
+import type { CliLang } from '../lib/i18n.js';
+export type Lang = CliLang;
+export { getCliLang, parseLangFromArgv };
+export interface BiText {
+    zh: string;
+    en: string;
+}
+/** 把双语对象拼成 `${zh}\n${en}` 串,塞给 oclif Command 的 static description / flags.description 等字段。 */
+export declare function bilingual(text: BiText): string;
+export declare const LANG_FLAG: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+/** 按 lang 把双语串切回单语;只有 1 行的串原样返回。 */
+export declare function pickLang(text: string | undefined, lang: Lang): string | undefined;
+/** 从 process.argv 解析 lang,优先级跟 ../i18n.ts 的 getCliLang 一致:CLI flag > OMK_LANG > zh。 */
+export declare function resolveLang(argv?: readonly string[]): Lang;
+//# sourceMappingURL=i18n.d.ts.map

package/dist/src/cli/oclif/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../../src/cli/oclif/i18n.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAE9C,MAAM,MAAM,IAAI,GAAG,OAAO,CAAC;AAE3B,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;AAEzC,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,8FAA8F;AAC9F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsB9C;AAED,eAAO,MAAM,SAAS,qGAMpB,CAAC;AAEH,oCAAoC;AACpC,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAMjF;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,IAAI,GAAE,SAAS,MAAM,EAAiB,GAAG,IAAI,CAExE"}

package/dist/src/cli/oclif/i18n.js

@@ -0,0 +1,62 @@
+// oclif 路径专用 i18n helper。生产 i18n 还是走 ../i18n.ts (tCli / tBoth) ——
+// 这里只提供 oclif Command static 字段需要的双语形式:
+// bilingual({zh, en}) → 字符串里 `${zh}\n${en}`,LangAwareHelp.formatCommand
+// 按 lang 切第一/第二行。
+//
+// 为什么用 \n 而不是显式 sentinel(如 [[ZH]]/[[EN]]):oclif 错误路径
+// (parse fail 时)硬编码 `new Help(config)`(node_modules/@oclif/core/lib/errors/handle.js
+// L44),绕过 package.json helpClass,所以 LangAwareHelp 不会被调到。
+// 显式 sentinel 在错误路径会原样泄漏给用户,可读性极差;\n 退化成「两种语言
+// 都各占一行」, 错误路径下用户至少能读懂。
+//
+// 代价:flag description 里不能用真换行 — 单行写到底,需要多段时换 prose
+// 文档（legacy 路径的 cli.help.observe 等仍然承担长 prose 角色)。
+//
+// 跟进(Phase B):改 oclif 上游让 errors/handle.js 尊重 helpClass / 接受双语 dump
+// 不再 fix(早期 init hook description mutate 方案 PR #124 已删,接受 BREAKING-CLI)。
+import { Flags } from '@oclif/core';
+import { getCliLang, parseLangFromArgv } from '../lib/i18n.js';
+export { getCliLang, parseLangFromArgv };
+/** 把双语对象拼成 `${zh}\n${en}` 串,塞给 oclif Command 的 static description / flags.description 等字段。 */
+export function bilingual(text) {
+    // 真换行会破坏 pickLang 的 split:第一行被当 zh,后续全归 en,zh 用户拿不到剩余段。
+    // codegen 也跟着错位且静默(因为 codegen 跟 help 共用同一份 split,两边一起错 = 自洽通过)。
+    // 单行写到底,需要多段时换 prose 文档(legacy cli.help.observe 等承担长 prose 角色)。
+    if (text.zh.includes('\n') || text.en.includes('\n')) {
+        throw new Error(`bilingual() does not support newlines in zh/en. Got zh=${JSON.stringify(text.zh)}, en=${JSON.stringify(text.en)}. ` +
+            `Use single-line description; place long prose in legacy cli.help.* dict.`);
+    }
+    // ejs 模板标记 `<% %>` 不允许出现在 description / flag.description / arg.description 里。
+    // oclif Help 用 ejs.render(body, context) 渲染所有 section,如果未来 description 被
+    // 拼了用户输入(skill 名、文件路径、env 值),`<%...%>` 会被执行成任意代码。
+    // by-design 的模板只在 example.command 字段(如 `<%= config.bin %>`),那个字段不走 bilingual()。
+    if (text.zh.includes('<%') || text.zh.includes('%>') || text.en.includes('<%') || text.en.includes('%>')) {
+        throw new Error(`bilingual() text must not contain ejs template markers (<% or %>). ` +
+            `oclif Help renders description through ejs; templates only belong in example.command. ` +
+            `Got zh=${JSON.stringify(text.zh)}, en=${JSON.stringify(text.en)}.`);
+    }
+    return `${text.zh}\n${text.en}`;
+}
+export const LANG_FLAG = Flags.string({
+    description: bilingual({
+        zh: '输出语言 zh|en，优先级 CLI > OMK_LANG env > zh。',
+        en: 'Output language zh|en. Priority: CLI > OMK_LANG env > zh.',
+    }),
+    default: 'zh',
+});
+/** 按 lang 把双语串切回单语;只有 1 行的串原样返回。 */
+export function pickLang(text, lang) {
+    if (text === undefined)
+        return undefined;
+    const parts = text.split(/\r?\n/);
+    if (parts.length < 2)
+        return text;
+    if (lang === 'zh')
+        return parts[0];
+    return parts.slice(1).join('\n');
+}
+/** 从 process.argv 解析 lang,优先级跟 ../i18n.ts 的 getCliLang 一致:CLI flag > OMK_LANG > zh。 */
+export function resolveLang(argv = process.argv) {
+    return getCliLang(parseLangFromArgv(argv));
+}
+//# sourceMappingURL=i18n.js.map

package/dist/src/cli/oclif/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.js","sourceRoot":"","sources":["../../../../src/cli/oclif/i18n.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,wCAAwC;AACxC,wEAAwE;AACxE,kBAAkB;AAClB,EAAE;AACF,qDAAqD;AACrD,qFAAqF;AACrF,yDAAyD;AACzD,8CAA8C;AAC9C,wBAAwB;AACxB,EAAE;AACF,mDAAmD;AACnD,mDAAmD;AACnD,EAAE;AACF,oEAAoE;AACpE,yEAAyE;AAEzE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAK/D,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC;AAOzC,8FAA8F;AAC9F,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,wDAAwD;IACxD,gEAAgE;IAChE,gEAAgE;IAChE,IAAI,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,KAAK,CACb,0DAA0D,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI;YACpH,0EAA0E,CAC3E,CAAC;IACJ,CAAC;IACD,8EAA8E;IAC9E,yEAAyE;IACzE,kDAAkD;IAClD,gFAAgF;IAChF,IAAI,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACzG,MAAM,IAAI,KAAK,CACb,qEAAqE;YACrE,wFAAwF;YACxF,UAAU,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CACpE,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,IAAI,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC;IACpC,WAAW,EAAE,SAAS,CAAC;QACrB,EAAE,EAAE,yCAAyC;QAC7C,EAAE,EAAE,2DAA2D;KAChE,CAAC;IACF,OAAO,EAAE,IAAI;CACd,CAAC,CAAC;AAEH,oCAAoC;AACpC,MAAM,UAAU,QAAQ,CAAC,IAAwB,EAAE,IAAU;IAC3D,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,WAAW,CAAC,OAA0B,OAAO,CAAC,IAAI;IAChE,OAAO,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7C,CAAC"}

package/dist/src/cli/oclif/parsers.d.ts

@@ -0,0 +1,10 @@
+interface NumericStringParserOptions {
+    min?: number;
+    minExclusive?: number;
+    max?: number;
+}
+export declare function integerStringParser(flag: string, options?: NumericStringParserOptions): (input: string) => Promise<string>;
+export declare function numberStringParser(flag: string, options?: NumericStringParserOptions): (input: string) => Promise<string>;
+export declare function enumStringParser(flag: string, values: readonly string[]): (input: string) => Promise<string>;
+export {};
+//# sourceMappingURL=parsers.d.ts.map

package/dist/src/cli/oclif/parsers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.d.ts","sourceRoot":"","sources":["../../../../src/cli/oclif/parsers.ts"],"names":[],"mappings":"AAEA,UAAU,0BAA0B;IAClC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAyDD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,0BAA+B,IAE1E,OAAO,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,CAoB9C;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,0BAA+B,IAEzE,OAAO,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,CAiB9C;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,MAAM,EAAE,IAExD,OAAO,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC,CAQ9C"}

package/dist/src/cli/oclif/parsers.js

@@ -0,0 +1,102 @@
+import { resolveLang } from './i18n.js';
+const DECIMAL_RE = /^-?(?:\d+(?:\.\d+)?|\.\d+)$/;
+function localize(text, lang = resolveLang(process.argv)) {
+    return lang === 'zh' ? text.zh : text.en;
+}
+function requirement(flag, kind, options) {
+    const noun = kind === 'integer'
+        ? { zh: '整数', en: 'integer' }
+        : { zh: '数字', en: 'number' };
+    const article = kind === 'integer' ? 'an' : 'a';
+    if (options.min !== undefined && options.max !== undefined) {
+        return {
+            zh: `${flag} 必须是 ${options.min} 到 ${options.max} 之间的${noun.zh}`,
+            en: `${flag} must be ${article} ${noun.en} between ${options.min} and ${options.max}`,
+        };
+    }
+    if (options.min !== undefined) {
+        return {
+            zh: `${flag} 必须是大于等于 ${options.min} 的${noun.zh}`,
+            en: `${flag} must be ${article} ${noun.en} greater than or equal to ${options.min}`,
+        };
+    }
+    if (options.minExclusive !== undefined) {
+        return {
+            zh: `${flag} 必须是大于 ${options.minExclusive} 的${noun.zh}`,
+            en: `${flag} must be ${article} ${noun.en} greater than ${options.minExclusive}`,
+        };
+    }
+    if (options.max !== undefined) {
+        return {
+            zh: `${flag} 必须是小于等于 ${options.max} 的${noun.zh}`,
+            en: `${flag} must be ${article} ${noun.en} less than or equal to ${options.max}`,
+        };
+    }
+    return {
+        zh: `${flag} 必须是${noun.zh}`,
+        en: `${flag} must be ${article} ${noun.en}`,
+    };
+}
+function numericError(flag, input, kind, options, lang = resolveLang(process.argv)) {
+    const req = requirement(flag, kind, options);
+    return new Error(localize({
+        zh: `${req.zh}，实际为 ${JSON.stringify(input)}。`,
+        en: `${req.en} (got ${JSON.stringify(input)}).`,
+    }, lang));
+}
+export function integerStringParser(flag, options = {}) {
+    const lang = resolveLang(process.argv);
+    return async (input) => {
+        const raw = input.trim();
+        if (!/^-?\d+$/.test(raw)) {
+            throw numericError(flag, input, 'integer', options, lang);
+        }
+        const value = Number(raw);
+        if (!Number.isSafeInteger(value)) {
+            throw numericError(flag, input, 'integer', options, lang);
+        }
+        if (options.min !== undefined && value < options.min) {
+            throw numericError(flag, input, 'integer', options, lang);
+        }
+        if (options.minExclusive !== undefined && value <= options.minExclusive) {
+            throw numericError(flag, input, 'integer', options, lang);
+        }
+        if (options.max !== undefined && value > options.max) {
+            throw numericError(flag, input, 'integer', options, lang);
+        }
+        return input;
+    };
+}
+export function numberStringParser(flag, options = {}) {
+    const lang = resolveLang(process.argv);
+    return async (input) => {
+        const raw = input.trim();
+        const value = Number(raw);
+        if (!DECIMAL_RE.test(raw) || !Number.isFinite(value)) {
+            throw numericError(flag, input, 'number', options, lang);
+        }
+        if (options.min !== undefined && value < options.min) {
+            throw numericError(flag, input, 'number', options, lang);
+        }
+        if (options.minExclusive !== undefined && value <= options.minExclusive) {
+            throw numericError(flag, input, 'number', options, lang);
+        }
+        if (options.max !== undefined && value > options.max) {
+            throw numericError(flag, input, 'number', options, lang);
+        }
+        return input;
+    };
+}
+export function enumStringParser(flag, values) {
+    const lang = resolveLang(process.argv);
+    return async (input) => {
+        if (values.includes(input))
+            return input;
+        const joined = values.join(' / ');
+        throw new Error(localize({
+            zh: `${flag} 必须是 ${joined} 之一，实际为 ${JSON.stringify(input)}。`,
+            en: `${flag} must be one of ${joined} (got ${JSON.stringify(input)}).`,
+        }, lang));
+    };
+}
+//# sourceMappingURL=parsers.js.map

package/dist/src/cli/oclif/parsers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsers.js","sourceRoot":"","sources":["../../../../src/cli/oclif/parsers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAe,MAAM,WAAW,CAAC;AAQrD,MAAM,UAAU,GAAG,6BAA6B,CAAC;AAEjD,SAAS,QAAQ,CAAC,IAAY,EAAE,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;IAC9D,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;AAC3C,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,IAA0B,EAAE,OAAmC;IAChG,MAAM,IAAI,GAAG,IAAI,KAAK,SAAS;QAC7B,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE;QAC7B,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC;IAC/B,MAAM,OAAO,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC;IAChD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC3D,OAAO;YACL,EAAE,EAAE,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,OAAO,IAAI,CAAC,EAAE,EAAE;YAC/D,EAAE,EAAE,GAAG,IAAI,YAAY,OAAO,IAAI,IAAI,CAAC,EAAE,YAAY,OAAO,CAAC,GAAG,QAAQ,OAAO,CAAC,GAAG,EAAE;SACtF,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO;YACL,EAAE,EAAE,GAAG,IAAI,YAAY,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC,EAAE,EAAE;YAChD,EAAE,EAAE,GAAG,IAAI,YAAY,OAAO,IAAI,IAAI,CAAC,EAAE,6BAA6B,OAAO,CAAC,GAAG,EAAE;SACpF,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACvC,OAAO;YACL,EAAE,EAAE,GAAG,IAAI,UAAU,OAAO,CAAC,YAAY,KAAK,IAAI,CAAC,EAAE,EAAE;YACvD,EAAE,EAAE,GAAG,IAAI,YAAY,OAAO,IAAI,IAAI,CAAC,EAAE,iBAAiB,OAAO,CAAC,YAAY,EAAE;SACjF,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO;YACL,EAAE,EAAE,GAAG,IAAI,YAAY,OAAO,CAAC,GAAG,KAAK,IAAI,CAAC,EAAE,EAAE;YAChD,EAAE,EAAE,GAAG,IAAI,YAAY,OAAO,IAAI,IAAI,CAAC,EAAE,0BAA0B,OAAO,CAAC,GAAG,EAAE;SACjF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,EAAE,EAAE,GAAG,IAAI,OAAO,IAAI,CAAC,EAAE,EAAE;QAC3B,EAAE,EAAE,GAAG,IAAI,YAAY,OAAO,IAAI,IAAI,CAAC,EAAE,EAAE;KAC5C,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CACnB,IAAY,EACZ,KAAa,EACb,IAA0B,EAC1B,OAAmC,EACnC,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;IAEhC,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7C,OAAO,IAAI,KAAK,CAAC,QAAQ,CAAC;QACxB,EAAE,EAAE,GAAG,GAAG,CAAC,EAAE,QAAQ,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG;QAC7C,EAAE,EAAE,GAAG,GAAG,CAAC,EAAE,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI;KAChD,EAAE,IAAI,CAAC,CAAC,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,UAAsC,EAAE;IACxF,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,KAAK,EAAE,KAAa,EAAmB,EAAE;QAC9C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;YACjC,MAAM,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YACrD,MAAM,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,KAAK,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACxE,MAAM,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5D,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YACrD,MAAM,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,UAAsC,EAAE;IACvF,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,KAAK,EAAE,KAAa,EAAmB,EAAE;QAC9C,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,MAAM,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YACrD,MAAM,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,KAAK,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;YACxE,MAAM,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YACrD,MAAM,YAAY,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,MAAyB;IACtE,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,OAAO,KAAK,EAAE,KAAa,EAAmB,EAAE;QAC9C,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACzC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC;YACvB,EAAE,EAAE,GAAG,IAAI,QAAQ,MAAM,WAAW,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG;YAC5D,EAAE,EAAE,GAAG,IAAI,mBAAmB,MAAM,SAAS,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI;SACvE,EAAE,IAAI,CAAC,CAAC,CAAC;IACZ,CAAC,CAAC;AACJ,CAAC"}

package/dist/src/cli/oclif/projection.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Command.Loadable → 单语视图 projection。
+ *
+ * 单一来源「oclif Command.Loadable 暴露给 help / docs 的单语形态」。
+ * help.ts 的 LangAwareHelp / docs 自动生成 等场景都从这里派生,避免每个
+ * 消费者各做一遍 reflection 跟 sentinel split,oclif 升级新字段(aliases /
+ * hidden / deprecationOptions)时只改一处。
+ *
+ * projectCommand 返回 clone,不 mutate 入参(LangAwareHelp 渲染前先 clone)。
+ *
+ * 已知盲区:oclif `errors/handle.js:L44` 硬编码 `new Help(config)` 不走 helpClass,
+ * parse error 时 dump 出来的 FLAGS / USAGE 拿到的是原 `${zh}\n${en}` 双语 sentinel,
+ * 不经 projectCommand 切单语 — 错误路径双语并列是已知 UX 限制(Phase B 评估能否
+ * fork @oclif/core 修)。
+ */
+import type { Command } from '@oclif/core';
+import { type Lang } from './i18n.js';
+export declare function projectCommand(cmd: Command.Loadable, lang: Lang): Command.Loadable;
+/** Topic 单语视图(无 flags / args / examples)。 */
+export declare function projectTopic<T extends {
+    description?: string;
+}>(topic: T, lang: Lang): T;
+//# sourceMappingURL=projection.d.ts.map

package/dist/src/cli/oclif/projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.d.ts","sourceRoot":"","sources":["../../../../src/cli/oclif/projection.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAY,KAAK,IAAI,EAAE,MAAM,WAAW,CAAC;AAEhD,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,QAAQ,CA8ClF;AAED,6CAA6C;AAC7C,wBAAgB,YAAY,CAAC,CAAC,SAAS;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,CAKxF"}

package/dist/src/cli/oclif/projection.js

@@ -0,0 +1,52 @@
+import { pickLang } from './i18n.js';
+export function projectCommand(cmd, lang) {
+    const out = { ...cmd };
+    if (cmd.description !== undefined) {
+        out.description = pickLang(cmd.description, lang);
+    }
+    if (cmd.summary !== undefined) {
+        out.summary = pickLang(cmd.summary, lang);
+    }
+    if (cmd.flags) {
+        const flags = {};
+        for (const [name, flag] of Object.entries(cmd.flags)) {
+            const f = flag;
+            flags[name] = {
+                ...flag,
+                description: pickLang(f.description, lang) ?? f.description,
+                summary: pickLang(f.summary, lang) ?? f.summary,
+            };
+        }
+        out.flags = flags;
+    }
+    if (cmd.args) {
+        const args = {};
+        for (const [name, arg] of Object.entries(cmd.args)) {
+            const a = arg;
+            args[name] = {
+                ...arg,
+                description: pickLang(a.description, lang) ?? a.description,
+            };
+        }
+        out.args = args;
+    }
+    if (Array.isArray(cmd.examples)) {
+        out.examples = cmd.examples.map((ex) => {
+            if (typeof ex === 'string')
+                return pickLang(ex, lang) ?? ex;
+            return {
+                ...ex,
+                description: pickLang(ex.description, lang) ?? ex.description,
+            };
+        });
+    }
+    return out;
+}
+/** Topic 单语视图(无 flags / args / examples)。 */
+export function projectTopic(topic, lang) {
+    return {
+        ...topic,
+        description: pickLang(topic.description, lang) ?? topic.description,
+    };
+}
+//# sourceMappingURL=projection.js.map

package/dist/src/cli/oclif/projection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projection.js","sourceRoot":"","sources":["../../../../src/cli/oclif/projection.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,QAAQ,EAAa,MAAM,WAAW,CAAC;AAEhD,MAAM,UAAU,cAAc,CAAC,GAAqB,EAAE,IAAU;IAC9D,MAAM,GAAG,GAAqB,EAAE,GAAG,GAAG,EAAE,CAAC;IAEzC,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAClC,GAAG,CAAC,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IACpD,CAAC;IACD,IAAI,GAAG,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC9B,GAAG,CAAC,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QACd,MAAM,KAAK,GAA4B,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,MAAM,CAAC,GAAG,IAAkD,CAAC;YAC7D,KAAK,CAAC,IAAI,CAAC,GAAG;gBACZ,GAAG,IAAI;gBACP,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW;gBAC3D,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO;aAChD,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,KAAK,GAAG,KAAyB,CAAC;IACxC,CAAC;IAED,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;QACb,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnD,MAAM,CAAC,GAAG,GAA+B,CAAC;YAC1C,IAAI,CAAC,IAAI,CAAC,GAAG;gBACX,GAAG,GAAG;gBACN,WAAW,EAAE,QAAQ,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW;aAC5D,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,IAAI,GAAG,IAAuB,CAAC;IACrC,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;YACrC,IAAI,OAAO,EAAE,KAAK,QAAQ;gBAAE,OAAO,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5D,OAAO;gBACL,GAAG,EAAE;gBACL,WAAW,EAAE,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW;aAC9D,CAAC;QACJ,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,YAAY,CAAqC,KAAQ,EAAE,IAAU;IACnF,OAAO;QACL,GAAG,KAAK;QACR,WAAW,EAAE,QAAQ,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,KAAK,CAAC,WAAW;KACpE,CAAC;AACJ,CAAC"}

package/dist/src/cli/oclif/run.d.ts

@@ -0,0 +1,2 @@
+export declare function runOclifPath(): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/src/cli/oclif/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../../src/cli/oclif/run.ts"],"names":[],"mappings":"AASA,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAElD"}

package/dist/src/cli/oclif/run.js

@@ -0,0 +1,11 @@
+import { execute } from '@oclif/core';
+// oclif dispatcher 入口。从 dist/src/cli/oclif/ 这个文件位置出发,oclif 用 package.json
+// oclif.commands(./dist/src/cli/commands)找到所有 Command 类。helpClass 也走
+// package.json 字段。
+//
+// 注意 dir: import.meta.url 必须传 — oclif 用它确定 package.json 跟 commands
+// dir 的相对位置。
+export async function runOclifPath() {
+    await execute({ dir: import.meta.url });
+}
+//# sourceMappingURL=run.js.map

package/dist/src/cli/oclif/run.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.js","sourceRoot":"","sources":["../../../../src/cli/oclif/run.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,0EAA0E;AAC1E,qEAAqE;AACrE,mBAAmB;AACnB,EAAE;AACF,mEAAmE;AACnE,aAAa;AAEb,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,MAAM,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;AAC1C,CAAC"}

package/dist/src/diagnosis/observe-mapper.d.ts

@@ -0,0 +1,68 @@
+import type { DiagnosisBundle, DiagnosisEvidenceRef, DiagnosisLifecycle } from './types.js';
+export interface ObserveDiagnosisInput {
+    generatedAt: string;
+    skillChainAdvisories?: SkillChainAdvisorySource[];
+    runtimeChecks?: ObservationRuntimeCheckSource[];
+    problemPatterns?: ExperienceProblemPatternSource[];
+    reviewerFindings?: ExperienceReviewerReportFindingSource[];
+    derivedStandards?: SkillDerivedStandardSource[];
+}
+export interface SkillChainAdvisorySource {
+    skillName: string;
+    code: 'hardrules_not_declared' | 'workflows_not_declared' | 'skill_md_not_found';
+    message?: string;
+    exampleYaml?: string;
+    commandTemplate?: string;
+    sourceId?: string;
+}
+export interface ObservationRuntimeCheckSource {
+    skillName: string;
+    id: string;
+    kind: 'hardRule' | 'workflowNode';
+    status: 'passed' | 'attention' | 'manual_review';
+    title?: string;
+    expectation?: string;
+    reason?: string;
+    evidenceRefs?: DiagnosisEvidenceRef[];
+    evidenceSnippets?: string[];
+}
+export interface ExperienceProblemPatternSource {
+    skillName: string;
+    bucket: string;
+    patternKey: string;
+    signalTypes: string[];
+    count: number;
+    sessionCount: number;
+    recentSessionIds?: string[];
+    evidenceRefs?: DiagnosisEvidenceRef[];
+    lastSeen?: string;
+}
+export interface ExperienceReviewerReportFindingSource {
+    skillName: string;
+    id: string;
+    judgmentId?: string;
+    source: 'deterministic_rule' | 'llm_soft' | 'manual';
+    level: 'info' | 'low' | 'medium' | 'high' | 'attention' | 'sample' | 'normal' | 'warning' | 'critical';
+    title?: string;
+    body?: string;
+    ruleSource: string;
+    ruleVersion?: string;
+    targetKey?: string;
+    evidenceRefs?: DiagnosisEvidenceRef[];
+}
+export interface SkillDerivedStandardSource {
+    skillName: string;
+    id: string;
+    kind: 'hard_rule_candidate' | 'workflow_candidate';
+    status: 'pending_review' | 'author_confirmed' | 'rejected' | 'stale';
+    title: string;
+    body?: string;
+    source?: 'llm_soft_standard' | 'manual';
+    confidence?: number;
+    evidence?: string[];
+    model?: string;
+    promptVersion?: string;
+}
+export declare function buildObserveDiagnostics(input: ObserveDiagnosisInput): DiagnosisBundle;
+export declare function maxLifecycle(a: DiagnosisLifecycle, b: DiagnosisLifecycle): DiagnosisLifecycle;
+//# sourceMappingURL=observe-mapper.d.ts.map

package/dist/src/diagnosis/observe-mapper.d.ts.map

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