oh-my-knowledge 0.30.0 → 0.32.0

package/dist/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/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/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/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/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/cli/oclif/parsers.js.map

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

package/dist/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/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/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/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/cli/oclif/run.d.ts

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

package/dist/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/cli/oclif/run.js

@@ -0,0 +1,11 @@
+import { execute } from '@oclif/core';
+// oclif dispatcher 入口。从 dist/cli/oclif/ 这个文件位置出发,oclif 用 package.json
+// oclif.commands(./dist/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/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,sEAAsE;AACtE,iEAAiE;AACjE,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/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/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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"}

package/dist/diagnosis/observe-mapper.js

@@ -0,0 +1,276 @@
+import { createHash } from 'node:crypto';
+const OBSERVE_ONLY_COVERAGE = { observe: true, doctor: false, eval: false };
+export function buildObserveDiagnostics(input) {
+    const byStableKey = new Map();
+    for (const advisory of input.skillChainAdvisories ?? []) {
+        upsertDiagnosis(byStableKey, advisoryToDiagnosis(input.generatedAt, advisory));
+    }
+    for (const check of input.runtimeChecks ?? []) {
+        const diagnosis = runtimeCheckToDiagnosis(input.generatedAt, check);
+        if (diagnosis)
+            upsertDiagnosis(byStableKey, diagnosis);
+    }
+    for (const pattern of input.problemPatterns ?? []) {
+        upsertDiagnosis(byStableKey, problemPatternToDiagnosis(input.generatedAt, pattern));
+    }
+    for (const finding of input.reviewerFindings ?? []) {
+        const diagnosis = reviewerFindingToDiagnosis(input.generatedAt, finding);
+        if (diagnosis)
+            upsertDiagnosis(byStableKey, diagnosis);
+    }
+    for (const standard of input.derivedStandards ?? []) {
+        upsertDiagnosis(byStableKey, derivedStandardToDiagnosis(input.generatedAt, standard));
+    }
+    const bySkill = {};
+    for (const diagnosis of byStableKey.values()) {
+        bySkill[diagnosis.skillName] ??= [];
+        bySkill[diagnosis.skillName].push(diagnosis);
+    }
+    for (const diagnoses of Object.values(bySkill)) {
+        diagnoses.sort((a, b) => severityRank(b.severity) - severityRank(a.severity) || a.signal.localeCompare(b.signal));
+    }
+    return {
+        schemaVersion: 1,
+        generatedAt: input.generatedAt,
+        sourceCoverage: { ...OBSERVE_ONLY_COVERAGE },
+        bySkill,
+    };
+}
+function advisoryToDiagnosis(generatedAt, advisory) {
+    const target = advisory.code === 'hardrules_not_declared'
+        ? 'definition:hardRules'
+        : advisory.code === 'workflows_not_declared'
+            ? 'definition:workflows'
+            : 'definition:skill_md';
+    const title = advisory.code === 'hardrules_not_declared'
+        ? 'Hard rules are not declared in SKILL.md'
+        : advisory.code === 'workflows_not_declared'
+            ? 'Workflow is not declared in SKILL.md'
+            : 'SKILL.md was not found';
+    return makeDiagnosis(generatedAt, {
+        skillName: advisory.skillName,
+        type: 'definition_gap',
+        signal: advisory.code,
+        target,
+        title,
+        summary: advisory.message,
+        severity: advisory.code === 'skill_md_not_found' ? 'high' : 'medium',
+        audience: 'skill-author',
+        lifecycle: 'detected',
+        sourceKind: 'skill_chain',
+        sourceId: advisory.sourceId ?? `skill_chain:${advisory.code}:${advisory.skillName}`,
+        evidenceRefs: [],
+        payload: { ...advisory },
+        recommendation: advisory.exampleYaml ? 'Move confirmed rules or workflow into SKILL.md frontmatter.' : undefined,
+        command: advisory.commandTemplate,
+        patch: advisory.exampleYaml
+            ? { target: 'definition', location: 'SKILL.md frontmatter', snippet: advisory.exampleYaml }
+            : undefined,
+    });
+}
+function runtimeCheckToDiagnosis(generatedAt, check) {
+    if (check.status === 'passed')
+        return null;
+    const target = check.kind === 'hardRule' ? `runtime:hardRule:${check.id}` : `runtime:workflowNode:${check.id}`;
+    return makeDiagnosis(generatedAt, {
+        skillName: check.skillName,
+        type: 'runtime_issue',
+        signal: check.kind === 'hardRule' ? 'runtime_hard_rule_review' : 'runtime_workflow_review',
+        target,
+        title: check.title ?? (check.kind === 'hardRule' ? 'Hard rule runtime check needs review' : 'Workflow runtime check needs review'),
+        summary: check.reason ?? check.expectation,
+        severity: check.status === 'manual_review' ? 'medium' : 'low',
+        audience: 'reviewer',
+        lifecycle: 'detected',
+        sourceKind: 'runtime_check',
+        sourceId: check.id,
+        evidenceRefs: check.evidenceRefs ?? [],
+        payload: { ...check },
+    });
+}
+function problemPatternToDiagnosis(generatedAt, pattern) {
+    const signal = pattern.signalTypes[0] ?? pattern.bucket;
+    return makeDiagnosis(generatedAt, {
+        skillName: pattern.skillName,
+        type: typeForPattern(pattern.bucket, signal),
+        signal,
+        target: `pattern:${pattern.bucket}:${pattern.patternKey}`,
+        title: `Repeated observe pattern: ${signal}`,
+        summary: `Seen in ${pattern.sessionCount} session(s), ${pattern.count} occurrence(s).`,
+        severity: pattern.sessionCount >= 3 ? 'high' : pattern.sessionCount >= 2 ? 'medium' : 'low',
+        audience: 'skill-author',
+        lifecycle: 'detected',
+        sourceKind: 'problem_pattern',
+        sourceId: pattern.patternKey,
+        evidenceRefs: pattern.evidenceRefs ?? [],
+        timestamp: pattern.lastSeen,
+        payload: { ...pattern },
+        // pattern.count = 总发生次数(可能跨多 session),用作 affectedCount 更贴近用户感知的「影响范围」,
+        // 比 sessionCount 更稳(单 session 内重复 10 次也算 10 次发生)。
+        occurrenceCount: pattern.count,
+    });
+}
+function reviewerFindingToDiagnosis(generatedAt, finding) {
+    if (finding.ruleSource === 'no_priority_signal')
+        return null;
+    const target = finding.targetKey ?? `reviewer:${finding.ruleSource}`;
+    return makeDiagnosis(generatedAt, {
+        skillName: finding.skillName,
+        type: typeForReviewerRule(finding.ruleSource),
+        signal: finding.ruleSource,
+        target,
+        title: titleForReviewerRule(finding.ruleSource, finding.title),
+        summary: finding.body,
+        severity: severityFromReviewerLevel(finding.level),
+        audience: 'reviewer',
+        lifecycle: 'detected',
+        sourceKind: finding.ruleSource,
+        sourceId: finding.id,
+        evidenceRefs: finding.evidenceRefs ?? [],
+        producer: finding.source,
+        payload: { ...finding },
+    });
+}
+function derivedStandardToDiagnosis(generatedAt, standard) {
+    return makeDiagnosis(generatedAt, {
+        skillName: standard.skillName,
+        type: 'standard_candidate',
+        signal: standard.kind,
+        target: `standard:${standard.kind}:${standard.id}`,
+        title: standard.title,
+        summary: standard.body,
+        severity: standard.status === 'author_confirmed' ? 'info' : 'low',
+        audience: 'skill-author',
+        lifecycle: lifecycleFromStandardStatus(standard.status),
+        sourceKind: standard.kind,
+        sourceId: standard.id,
+        evidenceRefs: [],
+        producer: standard.source === 'manual' ? 'manual' : 'llm_soft',
+        payload: { ...standard },
+        evidenceSummary: standard.evidence?.join('\n'),
+    });
+}
+function makeDiagnosis(generatedAt, input) {
+    const stableKey = [
+        `skill:${input.skillName}`,
+        `type:${input.type}`,
+        `signal:${input.signal}`,
+        `target:${input.target}`,
+    ].join('|');
+    const occurrence = {
+        id: hashParts('occurrence', stableKey, input.sourceKind, input.sourceId),
+        diagnosisStableKey: stableKey,
+        source: 'observe',
+        sourceId: input.sourceId,
+        sourceKind: input.sourceKind,
+        timestamp: input.timestamp ?? generatedAt,
+        severity: input.severity,
+        evidenceRefs: input.evidenceRefs,
+        producer: input.producer ?? 'deterministic_rule',
+        payload: input.payload,
+    };
+    return {
+        id: hashParts('diagnosis', stableKey),
+        stableKey,
+        skillName: input.skillName,
+        type: input.type,
+        signal: input.signal,
+        title: input.title,
+        summary: input.summary,
+        severity: input.severity,
+        audience: input.audience,
+        lifecycle: input.lifecycle,
+        scope: {
+            primary: input.target.startsWith('definition:') || input.target.startsWith('standard:') ? 'definition' : 'skill',
+            refs: { skillName: input.skillName },
+        },
+        occurrences: [occurrence],
+        occurrenceCount: input.occurrenceCount ?? 1,
+        evidenceSummary: input.evidenceSummary,
+        recommendation: input.recommendation,
+        command: input.command,
+        patch: input.patch,
+    };
+}
+function upsertDiagnosis(byStableKey, next) {
+    const existing = byStableKey.get(next.stableKey);
+    if (!existing) {
+        byStableKey.set(next.stableKey, next);
+        return;
+    }
+    existing.occurrences.push(...next.occurrences);
+    existing.occurrenceCount = existing.occurrences.length;
+    existing.severity = maxSeverity(existing.severity, next.severity);
+    existing.lifecycle = maxLifecycle(existing.lifecycle, next.lifecycle);
+}
+function typeForPattern(bucket, signal) {
+    if (bucket === 'definition_gap')
+        return 'definition_gap';
+    if (signal.includes('feedback') || signal.includes('correction') || signal.includes('interruption'))
+        return 'user_feedback_pattern';
+    return 'runtime_issue';
+}
+function typeForReviewerRule(ruleSource) {
+    if (ruleSource.includes('feedback') || ruleSource.includes('correction') || ruleSource.includes('interruption')) {
+        return 'user_feedback_pattern';
+    }
+    return 'runtime_issue';
+}
+function titleForReviewerRule(ruleSource, fallback) {
+    if (ruleSource === 'final_delivery_absent')
+        return 'Final delivery is missing in repeated runs';
+    if (ruleSource === 'tool_error_recovery')
+        return 'Tool failure recovery needs review';
+    return fallback ?? `Reviewer finding: ${ruleSource}`;
+}
+function severityFromReviewerLevel(level) {
+    if (level === 'critical' || level === 'high')
+        return 'high';
+    if (level === 'warning' || level === 'attention' || level === 'medium')
+        return 'medium';
+    if (level === 'sample' || level === 'low')
+        return 'low';
+    return 'info';
+}
+function lifecycleFromStandardStatus(status) {
+    if (status === 'pending_review')
+        return 'candidate';
+    if (status === 'author_confirmed')
+        return 'resolved';
+    if (status === 'rejected')
+        return 'rejected';
+    return 'stale';
+}
+function maxSeverity(a, b) {
+    return severityRank(a) >= severityRank(b) ? a : b;
+}
+export function maxLifecycle(a, b) {
+    // mapper 内的 upsert 合并语义:同一批 build 里多个 source 产生同 stableKey 时,
+    // 终态(resolved / rejected)是作者人为确认或驳回的结果,优先级高于自动检出态。
+    // 比如 `derivedStandard.author_confirmed` 已经把 standard 标 resolved,旁路再来一个
+    // 自动 detected 信号,应保留 resolved 而不是把 confirmation 擦掉。
+    // 「resolved 后新 occurrence 进来 reopen 到 detected」属于跨时间的 lifecycle 状态机,
+    // 由上层 review-state store 决定,不在此处处理。
+    const rank = {
+        resolved: 6,
+        rejected: 5,
+        detected: 4,
+        candidate: 3,
+        confirmed: 2,
+        stale: 1,
+    };
+    return rank[a] >= rank[b] ? a : b;
+}
+function severityRank(severity) {
+    if (severity === 'high')
+        return 4;
+    if (severity === 'medium')
+        return 3;
+    if (severity === 'low')
+        return 2;
+    return 1;
+}
+function hashParts(...parts) {
+    return createHash('sha256').update(parts.join('\u0000')).digest('hex').slice(0, 16);
+}
+//# sourceMappingURL=observe-mapper.js.map