oh-my-knowledge 0.32.0 → 0.34.0

package/dist/cli/lib/shared.js

@@ -5,7 +5,7 @@ export function requireEvaluationReport(report, id, lang) {
         console.error(tCli('cli.common.report_not_found', lang, { id }));
         throw new CliExit(1);
     }
-    if (report.kind === 'batch-evaluation') {
+    if (report.reportKind === 'batch-evaluation') {
         console.error(lang === 'zh'
             ? `报告 ${id} 是 BatchEvaluationReport。该命令需要单次 EvaluationReport；请使用其中的 child reportId。`
             : `Report ${id} is a BatchEvaluationReport. This command requires an EvaluationReport; use a child reportId from the batch.`);
@@ -23,4 +23,3 @@ 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

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

@@ -5,5 +5,69 @@ import { type CliLang } from './i18n.js';
  *  - release > prerelease(同 MAJOR.MINOR.PATCH)
  *  - prerelease 之间按 dot-separated identifier 比较(数字段当数字,字母段当字符串) */
 export declare function isSemverGt(a: string, b: string): boolean;
+/** 落盘缓存。展示只读它(热路径零网络);registry 抓取在后台写它,供下次运行用。 */
+export interface UpdateCache {
+    /** 上次抓到的 registry latest 版本。后台抓取成功才有;只发起过、还没成功时缺位。 */
+    latestVersion?: string;
+    /** 上次「发起检查」的时间(ISO)—— 成功失败都更新,是 20h 重抓节流的锚点。
+     *  父进程在 spawn 刷新前就写它,这样 registry 不通时也不会每条命令都重新拉起后台检查。 */
+    lastCheckedAt: string;
+    /** 上次提示过的版本,用于「同版本 20h 内不重复提示」。 */
+    lastNotifiedVersion?: string;
+    /** 上次提示时间(ISO)。 */
+    lastNotifiedAt?: string;
+}
+interface BoxParts {
+    current: string;
+    latest: string;
+    upgradeCmd: string;
+    silenceHint: string;
+}
+/** 缓存落盘走仓库既有约定 `~/.oh-my-knowledge/<...>`(见 src/eval-core/cache.ts、
+ *  src/server/job-store.ts)。home 可注入,方便测试传 tmp 目录。 */
+export declare function defaultCachePath(home?: string): string;
+/** 读缓存。缺失 / 损坏 / 非对象 / 缺时间锚点一律返回 null,调用方按「无缓存」处理。
+ *  lastCheckedAt(节流锚点)必须有;latestVersion 可缺(只发起过、还没抓成功的记录)。 */
+export declare function readCache(path: string): UpdateCache | null;
+/** 原子写(temp + rename),避免两个 omk 进程并发写出半截 JSON。homedir 不可写时
+ *  整体静默失败 — 退化为「每次后台重抓」,不崩。 */
+export declare function writeCache(path: string, data: UpdateCache): void;
+/** 是否该提示:有缓存的 latest 严格高于当前版本,且(没提示过这个版本 / 距上次提示超 20h)。
+ *  纯函数,now 外部注入,便于确定性测试。 */
+export declare function shouldNotify(cache: UpdateCache | null, currentVersion: string, now: Date, throttleMs?: number): boolean;
+/** 缓存是否过期(需后台重抓):无缓存 / 时间戳缺失或不可解析 / 超 ttl。 */
+export declare function isStale(cache: UpdateCache | null, now: Date, ttlMs?: number): boolean;
+/** 一次运行该做什么(纯函数,now 注入,便于确定性测试):
+ *  - notify:是否展示提示(仅凭缓存,无网络)。
+ *  - refresh:是否发起后台刷新。
+ *  - nextCache:需要落盘的新缓存,null 表示无需写。
+ *
+ *  关键:refresh 为真时,nextCache 一定带上 `lastCheckedAt = now` —— 即「发起检查」这件事本身
+ *  会立即落盘,所以 registry 持续不通时,下一次运行看到新鲜的 lastCheckedAt 就不再重复 spawn,
+ *  20h 节流对离线/失败同样生效(不退化成每条命令拉起后台检查)。 */
+export declare function planUpdateActions(cache: UpdateCache | null, currentVersion: string, now: Date): {
+    notify: boolean;
+    refresh: boolean;
+    nextCache: UpdateCache | null;
+};
+/** 终端可视宽度:全角 / CJK codepoint 计 2,其余计 1。用 [...str] 逐 codepoint
+ *  迭代以正确处理代理对。框内只用 width-1 的 ↑(U+2191)/→(U+2192),不放 emoji,
+ *  避免 emoji 宽度歧义破坏右边框对齐。 */
+export declare function visualWidth(str: string): number;
+/** 右补空格到目标可视宽度(已超宽则原样返回)。 */
+export declare function padToWidth(str: string, target: number): string;
+/** 渲染多行高亮边框(纯函数,可快照测试)。内宽取各行最大可视宽度,逐行用
+ *  padToWidth 对齐后画 ┌┐└┘─│ 框,返回前后留白、以 \n 结尾的整串。 */
+export declare function renderUpdateBox(parts: BoxParts, lang: CliLang): string;
+/** 选染提示文案:TTY 下多行高亮框,管道 / 非 TTY 退回单行(不污染输出)。纯函数,
+ *  isTty 注入便于测试两条分支。 */
+export declare function renderNotice(parts: BoxParts, pkgName: string, lang: CliLang, isTty: boolean): string;
+/** spawn 一个 detached + unref 的子进程跑 worker。子进程启动失败(ENOENT / EACCES /
+ *  EAGAIN)是异步 `error` 事件 —— 不挂 listener 的话 Node 会当 uncaught exception 抛出、
+ *  反过来拖垮主命令,所以必须挂个空 handler 吞掉,维持升级检查全程 fail-silent。 */
+export declare function spawnDetached(scriptPath: string, args: string[]): void;
+/** 升级提示:展示与抓取解耦。本次运行只读缓存即时决定是否提示(热路径零网络);
+ *  缓存过期时后台抓一次写回,供下次用。首次运行(无缓存)不提示。全程 fail-silent,
+ *  由 index.ts 在非短路径下 fire-and-forget 调用。 */
 export declare function checkUpdate(lang: CliLang): Promise<void>;
-//# sourceMappingURL=update-check.d.ts.map
+export {};

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

@@ -1,3 +1,8 @@
+import { spawn } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, renameSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { tCli } from './i18n.js';
 /** 严格按 SemVer 2.0 precedence 判断 `a > b`(只覆盖本仓库实际使用的形态:
  *  MAJOR.MINOR.PATCH 可选 `-prerelease`)。非法字符串直接返回 false,update-check
@@ -71,43 +76,226 @@ function shouldSkipUpdateCheck() {
         return true;
     return false;
 }
-export async function checkUpdate(lang) {
-    if (shouldSkipUpdateCheck())
-        return;
+/** 统一的 20h 时间窗,两处共用:同一新版本最多提示一次的节流窗口、registry 重抓的过期窗口。
+ *  够长,高频命令下既不反复打网络也不反复 nag;又短于一天,用户隔天能再被提醒一次。 */
+const UPDATE_WINDOW_MS = 20 * 3600_000;
+/** 缓存落盘走仓库既有约定 `~/.oh-my-knowledge/<...>`(见 src/eval-core/cache.ts、
+ *  src/server/job-store.ts)。home 可注入,方便测试传 tmp 目录。 */
+export function defaultCachePath(home = homedir()) {
+    return join(home, '.oh-my-knowledge', 'update-check.json');
+}
+/** 读缓存。缺失 / 损坏 / 非对象 / 缺时间锚点一律返回 null,调用方按「无缓存」处理。
+ *  lastCheckedAt(节流锚点)必须有;latestVersion 可缺(只发起过、还没抓成功的记录)。 */
+export function readCache(path) {
     try {
-        const { readFileSync, existsSync } = await import('node:fs');
-        const { fileURLToPath } = await import('node:url');
-        const { dirname, join } = await import('node:path');
-        const __dirname = dirname(fileURLToPath(import.meta.url));
-        // 从当前文件位置向上找 package.json:dev 跑 src/cli/lib/ 时 3 层到根,
-        // 装到 npm 跑 dist/cli/lib/ 时 3 层到 oh-my-knowledge/。5 次给点 buffer。
-        const findPackageJson = (startDir) => {
-            let dir = startDir;
-            for (let i = 0; i < 5; i++) {
-                const candidate = join(dir, 'package.json');
-                if (existsSync(candidate))
-                    return candidate;
-                dir = dirname(dir);
-            }
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+            return null;
+        const obj = parsed;
+        if (typeof obj.lastCheckedAt !== 'string')
             return null;
+        const str = (v) => (typeof v === 'string' ? v : undefined);
+        return {
+            latestVersion: str(obj.latestVersion),
+            lastCheckedAt: obj.lastCheckedAt,
+            lastNotifiedVersion: str(obj.lastNotifiedVersion),
+            lastNotifiedAt: str(obj.lastNotifiedAt),
         };
-        const pkgPath = findPackageJson(__dirname);
-        if (!pkgPath)
+    }
+    catch {
+        return null;
+    }
+}
+/** 原子写(temp + rename),避免两个 omk 进程并发写出半截 JSON。homedir 不可写时
+ *  整体静默失败 — 退化为「每次后台重抓」,不崩。 */
+export function writeCache(path, data) {
+    try {
+        mkdirSync(dirname(path), { recursive: true });
+        const tmp = `${path}.tmp.${process.pid}`;
+        writeFileSync(tmp, JSON.stringify(data, null, 2));
+        renameSync(tmp, path);
+    }
+    catch {
+        /* 静默:缓存是装饰性状态,写不进去不影响功能 */
+    }
+}
+/** 是否该提示:有缓存的 latest 严格高于当前版本,且(没提示过这个版本 / 距上次提示超 20h)。
+ *  纯函数,now 外部注入,便于确定性测试。 */
+export function shouldNotify(cache, currentVersion, now, throttleMs = UPDATE_WINDOW_MS) {
+    if (!cache?.latestVersion || !isSemverGt(cache.latestVersion, currentVersion))
+        return false;
+    if (cache.lastNotifiedVersion !== cache.latestVersion)
+        return true;
+    if (!cache.lastNotifiedAt)
+        return true;
+    const last = Date.parse(cache.lastNotifiedAt);
+    if (Number.isNaN(last))
+        return true;
+    return now.getTime() - last > throttleMs;
+}
+/** 缓存是否过期(需后台重抓):无缓存 / 时间戳缺失或不可解析 / 超 ttl。 */
+export function isStale(cache, now, ttlMs = UPDATE_WINDOW_MS) {
+    if (!cache?.lastCheckedAt)
+        return true;
+    const last = Date.parse(cache.lastCheckedAt);
+    if (Number.isNaN(last))
+        return true;
+    return now.getTime() - last > ttlMs;
+}
+/** 一次运行该做什么(纯函数,now 注入,便于确定性测试):
+ *  - notify:是否展示提示(仅凭缓存,无网络)。
+ *  - refresh:是否发起后台刷新。
+ *  - nextCache:需要落盘的新缓存,null 表示无需写。
+ *
+ *  关键:refresh 为真时,nextCache 一定带上 `lastCheckedAt = now` —— 即「发起检查」这件事本身
+ *  会立即落盘,所以 registry 持续不通时,下一次运行看到新鲜的 lastCheckedAt 就不再重复 spawn,
+ *  20h 节流对离线/失败同样生效(不退化成每条命令拉起后台检查)。 */
+export function planUpdateActions(cache, currentVersion, now) {
+    const nowIso = now.toISOString();
+    const notify = shouldNotify(cache, currentVersion, now);
+    const refresh = isStale(cache, now);
+    let nextCache = null;
+    if (notify && cache) {
+        nextCache = { ...cache, lastNotifiedVersion: cache.latestVersion, lastNotifiedAt: nowIso };
+    }
+    if (refresh) {
+        nextCache = { ...(nextCache ?? cache ?? {}), lastCheckedAt: nowIso };
+    }
+    return { notify, refresh, nextCache };
+}
+/** 终端可视宽度:全角 / CJK codepoint 计 2,其余计 1。用 [...str] 逐 codepoint
+ *  迭代以正确处理代理对。框内只用 width-1 的 ↑(U+2191)/→(U+2192),不放 emoji,
+ *  避免 emoji 宽度歧义破坏右边框对齐。 */
+export function visualWidth(str) {
+    let width = 0;
+    for (const ch of str) {
+        const cp = ch.codePointAt(0) ?? 0;
+        width += isWideCodePoint(cp) ? 2 : 1;
+    }
+    return width;
+}
+function isWideCodePoint(cp) {
+    return ((cp >= 0x1100 && cp <= 0x115f) || // Hangul Jamo
+        (cp >= 0x2e80 && cp <= 0xa4cf) || // CJK 部首 … 彝文;含 CJK 标点(3000-303F「。、」)与统一表意(4E00-9FFF)
+        (cp >= 0xac00 && cp <= 0xd7a3) || // Hangul 音节
+        (cp >= 0xf900 && cp <= 0xfaff) || // CJK 兼容表意
+        (cp >= 0xfe30 && cp <= 0xfe4f) || // CJK 兼容形式
+        (cp >= 0xff00 && cp <= 0xff60) || // 全角 ASCII / 标点
+        (cp >= 0xffe0 && cp <= 0xffe6) // 全角符号
+    );
+}
+/** 右补空格到目标可视宽度(已超宽则原样返回)。 */
+export function padToWidth(str, target) {
+    const pad = target - visualWidth(str);
+    return pad > 0 ? str + ' '.repeat(pad) : str;
+}
+/** 渲染多行高亮边框(纯函数,可快照测试)。内宽取各行最大可视宽度,逐行用
+ *  padToWidth 对齐后画 ┌┐└┘─│ 框,返回前后留白、以 \n 结尾的整串。 */
+export function renderUpdateBox(parts, lang) {
+    const lines = [
+        tCli('cli.update.box_title', lang),
+        tCli('cli.update.box_version_line', lang, { old: parts.current, new: parts.latest }),
+        tCli('cli.update.box_upgrade_line', lang, { cmd: parts.upgradeCmd }),
+        tCli('cli.update.box_silence_line', lang, { env: parts.silenceHint }),
+    ];
+    const inner = Math.max(...lines.map(visualWidth));
+    const top = `┌${'─'.repeat(inner + 2)}┐`;
+    const bottom = `└${'─'.repeat(inner + 2)}┘`;
+    const body = lines.map((l) => `│ ${padToWidth(l, inner)} │`);
+    return `\n${[top, ...body, bottom].join('\n')}\n\n`;
+}
+/** 选染提示文案:TTY 下多行高亮框,管道 / 非 TTY 退回单行(不污染输出)。纯函数,
+ *  isTty 注入便于测试两条分支。 */
+export function renderNotice(parts, pkgName, lang, isTty) {
+    if (isTty)
+        return renderUpdateBox(parts, lang);
+    return tCli('cli.update.new_version_available', lang, {
+        old: parts.current,
+        new: parts.latest,
+        pkg: pkgName,
+    });
+}
+/** 从当前文件位置向上找 package.json:dev 跑 src/cli/lib/ 时 3 层到根,
+ *  装到 npm 跑 dist/cli/lib/ 时 3 层到 oh-my-knowledge/。5 次给点 buffer。 */
+function readLocalPkg() {
+    try {
+        let dir = dirname(fileURLToPath(import.meta.url));
+        for (let i = 0; i < 5; i++) {
+            const candidate = join(dir, 'package.json');
+            if (existsSync(candidate)) {
+                const pkg = JSON.parse(readFileSync(candidate, 'utf-8'));
+                if (!pkg.name || !pkg.version)
+                    return null;
+                return {
+                    name: pkg.name,
+                    version: pkg.version,
+                    // 优先用用户实际安装源(npm 从 .npmrc 注入 npm_config_registry),再退 publish 目标,最后兜底官方源
+                    registry: process.env.npm_config_registry || pkg.publishConfig?.registry || 'https://registry.npmjs.org',
+                };
+            }
+            dir = dirname(dir);
+        }
+    }
+    catch {
+        /* fall through */
+    }
+    return null;
+}
+/** 后台刷新:spawn 一个 detached + unref 的子进程去抓 registry latest 写回缓存,跟父进程
+ *  生命周期解耦 —— native fetch 的网络 handle 会让进程存活到请求完成 / 3s abort,留在父进程里
+ *  会拖住快命令的退出;丢给独立子进程后,父进程发完 spawn 立即返回、可正常退出,热路径零网络。
+ *  worker 只在编译产物(dist/cli/lib/)里有 `.js`;dev 直接跑源码时不存在,existsSync 兜底跳过。 */
+function fetchAndStore(path, pkg) {
+    try {
+        const worker = join(dirname(fileURLToPath(import.meta.url)), 'update-fetch-worker.js');
+        if (!existsSync(worker))
             return;
-        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
-        const registry = pkg.publishConfig?.registry || 'https://registry.npmjs.org';
-        const res = await fetch(`${registry}/${pkg.name}/latest`, { signal: AbortSignal.timeout(3000) });
-        if (!res.ok)
+        spawnDetached(worker, [path, pkg.registry, pkg.name]);
+    }
+    catch {
+        /* 静默:spawn 同步抛错(罕见)不影响正常使用 */
+    }
+}
+/** spawn 一个 detached + unref 的子进程跑 worker。子进程启动失败(ENOENT / EACCES /
+ *  EAGAIN)是异步 `error` 事件 —— 不挂 listener 的话 Node 会当 uncaught exception 抛出、
+ *  反过来拖垮主命令,所以必须挂个空 handler 吞掉,维持升级检查全程 fail-silent。 */
+export function spawnDetached(scriptPath, args) {
+    const child = spawn(process.execPath, [scriptPath, ...args], { detached: true, stdio: 'ignore' });
+    child.on('error', () => {
+        /* 静默:子进程起不来不影响主命令 */
+    });
+    child.unref();
+}
+/** 升级提示:展示与抓取解耦。本次运行只读缓存即时决定是否提示(热路径零网络);
+ *  缓存过期时后台抓一次写回,供下次用。首次运行(无缓存)不提示。全程 fail-silent,
+ *  由 index.ts 在非短路径下 fire-and-forget 调用。 */
+export async function checkUpdate(lang) {
+    if (shouldSkipUpdateCheck())
+        return;
+    try {
+        const pkg = readLocalPkg();
+        if (!pkg)
             return;
-        const data = await res.json();
-        // 只在 registry 版本 SemVer 严格大于本地版本时提示。早先版本用 `!==`
-        // 比较,本地 dev 跑出 0.32.0-rc 时会被 registry 的 0.31.0「提示降级」。
-        if (data.version && isSemverGt(data.version, pkg.version)) {
-            process.stderr.write(tCli('cli.update.new_version_available', lang, {
-                old: pkg.version, new: data.version, pkg: pkg.name,
-            }));
+        const path = defaultCachePath();
+        const cache = readCache(path);
+        const plan = planUpdateActions(cache, pkg.version, new Date());
+        // 展示:仅凭缓存,无网络
+        if (plan.notify && cache?.latestVersion) {
+            const parts = {
+                current: pkg.version,
+                latest: cache.latestVersion,
+                upgradeCmd: 'npm i -g oh-my-knowledge@latest',
+                silenceHint: 'OMK_SKIP_UPDATE_CHECK=1',
+            };
+            process.stderr.write(renderNotice(parts, pkg.name, lang, process.stderr.isTTY === true));
         }
+        // 先把「发起检查」落盘(节流锚点),再 spawn 后台刷新 —— 失败/离线也不会每条命令重来
+        if (plan.nextCache)
+            writeCache(path, plan.nextCache);
+        if (plan.refresh)
+            fetchAndStore(path, pkg);
+    }
+    catch {
+        /* 静默失败,不影响正常使用 */
     }
-    catch { /* 静默失败,不影响正常使用 */ }
 }
-//# sourceMappingURL=update-check.js.map

package/dist/cli/lib/update-fetch-worker.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/cli/lib/update-fetch-worker.js

@@ -0,0 +1,34 @@
+/**
+ * 升级检查的后台刷新 worker。由 update-check.ts 的 fetchAndStore 以 detached + unref
+ * spawn,独立于父 CLI 进程运行:抓 registry latest 写回 ~/.oh-my-knowledge/update-check.json,
+ * 供下次运行展示用。父进程不等它,所以这里阻塞式 await fetch 没关系。全程 fail-silent。
+ *
+ * argv: [node, update-fetch-worker.js, cachePath, registry, pkgName]
+ */
+import { readCache, writeCache } from './update-check.js';
+async function main() {
+    const [cachePath, registry, name] = process.argv.slice(2);
+    if (!cachePath || !registry || !name)
+        return;
+    try {
+        const res = await fetch(`${registry.replace(/\/$/, '')}/${name}/latest`, {
+            signal: AbortSignal.timeout(3000),
+        });
+        if (!res.ok)
+            return;
+        const data = (await res.json());
+        if (!data.version)
+            return;
+        const prev = readCache(cachePath); // 重读以保留展示侧写的 notify 节流字段,别覆盖
+        writeCache(cachePath, {
+            latestVersion: data.version,
+            lastCheckedAt: new Date().toISOString(),
+            lastNotifiedVersion: prev?.lastNotifiedVersion,
+            lastNotifiedAt: prev?.lastNotifiedAt,
+        });
+    }
+    catch {
+        /* 静默:网络 / 超时 / 解析 / 磁盘任一失败都不影响 */
+    }
+}
+void main();

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

@@ -5,4 +5,3 @@ export declare abstract class BaseCommand extends Command {
     protected get lang(): Lang;
     protected runWithCliExit(fn: () => Promise<void>): Promise<void>;
 }
-//# sourceMappingURL=base-command.d.ts.map

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

@@ -24,4 +24,3 @@ export class BaseCommand extends Command {
         }
     }
 }
-//# sourceMappingURL=base-command.js.map

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

@@ -13,4 +13,3 @@ export default class LangAwareHelp extends Help {
         description?: string;
     }>): string;
 }
-//# sourceMappingURL=help.d.ts.map

package/dist/cli/oclif/help.js

@@ -30,4 +30,3 @@ export default class LangAwareHelp extends Help {
         return super.formatTopics(topics.map((t) => projectTopic(t, this.lang)));
     }
 }
-//# sourceMappingURL=help.js.map

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

@@ -13,4 +13,3 @@ export declare const LANG_FLAG: import("@oclif/core/interfaces").OptionFlag<stri
 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/cli/oclif/i18n.js

@@ -59,4 +59,3 @@ export function pickLang(text, lang) {
 export function resolveLang(argv = process.argv) {
     return getCliLang(parseLangFromArgv(argv));
 }
-//# sourceMappingURL=i18n.js.map

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

@@ -7,4 +7,3 @@ export declare function integerStringParser(flag: string, options?: NumericStrin
 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.js

@@ -99,4 +99,3 @@ export function enumStringParser(flag, values) {
         }, lang));
     };
 }
-//# sourceMappingURL=parsers.js.map

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

@@ -20,4 +20,3 @@ export declare function projectCommand(cmd: Command.Loadable, lang: Lang): Comma
 export declare function projectTopic<T extends {
     description?: string;
 }>(topic: T, lang: Lang): T;
-//# sourceMappingURL=projection.d.ts.map

package/dist/cli/oclif/projection.js

@@ -49,4 +49,3 @@ export function projectTopic(topic, lang) {
         description: pickLang(topic.description, lang) ?? topic.description,
     };
 }
-//# sourceMappingURL=projection.js.map

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

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

package/dist/cli/oclif/run.js

@@ -8,4 +8,3 @@ import { execute } from '@oclif/core';
 export async function runOclifPath() {
     await execute({ dir: import.meta.url });
 }
-//# sourceMappingURL=run.js.map

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

@@ -18,7 +18,7 @@ export interface SkillChainAdvisorySource {
 export interface ObservationRuntimeCheckSource {
     skillName: string;
     id: string;
-    kind: 'hardRule' | 'workflowNode';
+    nodeKind: 'hardRule' | 'workflowNode';
     status: 'passed' | 'attention' | 'manual_review';
     title?: string;
     expectation?: string;
@@ -53,7 +53,7 @@ export interface ExperienceReviewerReportFindingSource {
 export interface SkillDerivedStandardSource {
     skillName: string;
     id: string;
-    kind: 'hard_rule_candidate' | 'workflow_candidate';
+    standardKind: 'hard_rule_candidate' | 'workflow_candidate';
     status: 'pending_review' | 'author_confirmed' | 'rejected' | 'stale';
     title: string;
     body?: string;
@@ -65,4 +65,3 @@ export interface SkillDerivedStandardSource {
 }
 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.js

@@ -71,13 +71,13 @@ function advisoryToDiagnosis(generatedAt, advisory) {
 function runtimeCheckToDiagnosis(generatedAt, check) {
     if (check.status === 'passed')
         return null;
-    const target = check.kind === 'hardRule' ? `runtime:hardRule:${check.id}` : `runtime:workflowNode:${check.id}`;
+    const target = check.nodeKind === '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',
+        signal: check.nodeKind === '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'),
+        title: check.title ?? (check.nodeKind === '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',
@@ -135,14 +135,14 @@ function derivedStandardToDiagnosis(generatedAt, standard) {
     return makeDiagnosis(generatedAt, {
         skillName: standard.skillName,
         type: 'standard_candidate',
-        signal: standard.kind,
-        target: `standard:${standard.kind}:${standard.id}`,
+        signal: standard.standardKind,
+        target: `standard:${standard.standardKind}:${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,
+        sourceKind: standard.standardKind,
         sourceId: standard.id,
         evidenceRefs: [],
         producer: standard.source === 'manual' ? 'manual' : 'llm_soft',
@@ -273,4 +273,3 @@ function severityRank(severity) {
 function hashParts(...parts) {
     return createHash('sha256').update(parts.join('\u0000')).digest('hex').slice(0, 16);
 }
-//# sourceMappingURL=observe-mapper.js.map

package/dist/diagnosis/observe-producer.d.ts

@@ -6,4 +6,3 @@ export interface BuildObserveDiagnosticsFromReportOptions {
     skillChains?: Record<string, ObservationSkillChain>;
 }
 export declare function buildObserveDiagnosticsFromReport(report: ObservationInboxReport, options?: BuildObserveDiagnosticsFromReportOptions): DiagnosisBundle;
-//# sourceMappingURL=observe-producer.d.ts.map

package/dist/diagnosis/observe-producer.js

@@ -112,7 +112,7 @@ function chainRuntimeChecks(chain) {
         .map((check) => ({
         skillName: chain.skillName,
         id: check.id,
-        kind: check.kind,
+        nodeKind: check.nodeKind,
         status: check.status,
         title: check.title,
         expectation: check.expectation,
@@ -123,8 +123,8 @@ function chainRuntimeChecks(chain) {
 }
 function evidenceRefsFromRuntimeCheck(check, skillName) {
     return (check.evidenceSnippets ?? []).map((snippet, index) => ({
-        id: `runtime:${skillName}:${check.kind}:${check.id}:${index}`,
-        kind: check.kind,
+        id: `runtime:${skillName}:${check.nodeKind}:${check.id}:${index}`,
+        kind: check.nodeKind,
         label: check.title,
         snippet,
     }));
@@ -196,4 +196,3 @@ function evidenceRef(ref) {
         snippet: ref.snippet,
     };
 }
-//# sourceMappingURL=observe-producer.js.map

package/dist/diagnosis/studio-projection.d.ts

@@ -4,4 +4,3 @@ export declare function buildStudioDiagnosisSummary(bundle?: DiagnosisBundle): S
 export declare function countDiagnostics(bundle?: DiagnosisBundle): number;
 export declare function mergeDiagnosisBundles(bundles: DiagnosisBundle[], generatedAt?: string): DiagnosisBundle;
 export declare function activeStudioDiagnostics(bundle?: DiagnosisBundle): Diagnosis[];
-//# sourceMappingURL=studio-projection.d.ts.map

package/dist/diagnosis/studio-projection.js

@@ -81,4 +81,3 @@ function severityRank(severity) {
         return 2;
     return 1;
 }
-//# sourceMappingURL=studio-projection.js.map

package/dist/diagnosis/types.d.ts

@@ -1,4 +1,3 @@
 export type { Diagnosis, DiagnosisAudience, DiagnosisBundle, DiagnosisEvidenceRef, DiagnosisLifecycle, DiagnosisOccurrence, DiagnosisPatch, DiagnosisScope, DiagnosisSeverity, DiagnosisSource, DiagnosisSourceCoverage, DiagnosisType, StudioDiagnosisSummary, } from '../types/diagnosis.js';
 import type { DiagnosisLifecycle } from '../types/diagnosis.js';
 export declare function isActiveDiagnosisLifecycle(lifecycle: DiagnosisLifecycle): boolean;
-//# sourceMappingURL=types.d.ts.map

package/dist/diagnosis/types.js

@@ -17,4 +17,3 @@ const ACTIVE_DIAGNOSIS_LIFECYCLES = new Set([
 export function isActiveDiagnosisLifecycle(lifecycle) {
     return ACTIVE_DIAGNOSIS_LIFECYCLES.has(lifecycle);
 }
-//# sourceMappingURL=types.js.map

package/dist/doctor/fixer.d.ts

@@ -9,4 +9,3 @@ export interface FixOptions {
     resolveSkillPath?: (reportPath: string) => string;
 }
 export declare function runDoctorFix(opts: FixOptions): Promise<boolean>;
-//# sourceMappingURL=fixer.d.ts.map

package/dist/doctor/fixer.js

@@ -323,4 +323,3 @@ export async function runDoctorFix(opts) {
     }
     return changed;
 }
-//# sourceMappingURL=fixer.js.map

package/dist/doctor/health/builtin-dimensions.d.ts

@@ -8,4 +8,3 @@
  */
 import type { HealthDimensionSpec } from './dimension-spec.js';
 export declare const BUILTIN_HEALTH_DIMENSIONS: HealthDimensionSpec[];
-//# sourceMappingURL=builtin-dimensions.d.ts.map

package/dist/doctor/health/builtin-dimensions.js

@@ -88,4 +88,3 @@ export const BUILTIN_HEALTH_DIMENSIONS = [
 注意:大多数 skill 即使没有示例,LLM 也能从指令描述中推断出正确用法。只有格式确实复杂且无法从描述中推断时才报。`,
     },
 ];
-//# sourceMappingURL=builtin-dimensions.js.map

package/dist/doctor/health/composer.d.ts

@@ -16,4 +16,3 @@ import type { ComposerRule } from '../../types/doctor.js';
 export declare const SKILL_HEALTH_COMPOSER_ID = "skill_health";
 export type ExecutorFactory = (name: string) => ExecutorFn;
 export declare function makeSkillHealthComposer(execFactory?: ExecutorFactory): ComposerRule;
-//# sourceMappingURL=composer.d.ts.map

package/dist/doctor/health/composer.js

@@ -130,7 +130,7 @@ function listSiblingSkills(skillRoot) {
 export function makeSkillHealthComposer(execFactory = defaultExecutorFactory) {
     return {
         id: SKILL_HEALTH_COMPOSER_ID,
-        kind: 'composer',
+        ruleKind: 'composer',
         severity: 'fatal',
         labelKey: 'cli.doctor.rule.skill_health_check',
         checkAll: (ctx) => composerCheckAll(ctx, execFactory),
@@ -293,4 +293,3 @@ function errorSummaryOutcome(ctx, phase, errMsg, extra = {}) {
         detail: { phase, error: errMsg, ...extra },
     };
 }
-//# sourceMappingURL=composer.js.map

package/dist/doctor/health/dimension-registry.d.ts

@@ -10,4 +10,3 @@ import type { HealthDimensionSpec } from './dimension-spec.js';
 export declare function registerHealthDimension(spec: HealthDimensionSpec): void;
 export declare function getRegisteredHealthDimensions(): HealthDimensionSpec[];
 export declare function __resetHealthDimensionsForTest(): void;
-//# sourceMappingURL=dimension-registry.d.ts.map