oh-my-knowledge 0.27.0 → 0.28.0

package/dist/src/doctor/health/parser.d.ts

@@ -0,0 +1,27 @@
+/**
+ * LLM 输出解析:JSON 提取 + dim_id 派发 + 容错。
+ *
+ * 流程:
+ *   1. extractJson 从 LLM 文本(可能带寒暄/code fence)抽出顶层 JSON。
+ *   2. 按 dim_id 把 checklist 项派发到 Map<dimId, HealthDimensionResult>。
+ *   3. 缺失维度(LLM 漏报)塞 _missing=true 的 placeholder,composer 据此 status=skipped。
+ *   4. 不合法 dim_id(LLM 编了 registry 之外的)直接丢弃。
+ *
+ * dimension_level_count / finding_count_by_level 由调用方 / renderer 自己算
+ * (LLM 算术不可靠,prompt 已声明不输出这两字段)。
+ */
+import type { HealthDimensionResult, HealthDimensionSpec } from './dimension-spec.js';
+/** 深度跟踪 brace,在 LLM 文本里找出顶层 JSON。多个候选时优先选含 ≥2 required key 的。 */
+export declare function extractJson(text: string): string | null;
+export interface HealthParseResult {
+    byDimId: Map<string, HealthDimensionResult>;
+    /** LLM 给的 overall(框架视情况覆盖)。 */
+    overall: '良好' | '部分缺陷' | '严重缺陷' | null;
+    topSuggestions: string[];
+    /** 原样保留 feature_points,塞进 composer 主结果 detail。 */
+    featurePoints: unknown[];
+}
+/** 从 cleaned JSON 字串(extractJson 的输出)派发到各维度。 */
+export declare function parseHealthOutput(jsonText: string, dims: HealthDimensionSpec[]): HealthParseResult;
+export declare function deriveOverallHealth(byDimId: Map<string, HealthDimensionResult>): '良好' | '部分缺陷' | '严重缺陷';
+//# sourceMappingURL=parser.d.ts.map

package/dist/src/doctor/health/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../../src/doctor/health/parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EAIpB,MAAM,qBAAqB,CAAC;AAS7B,iEAAiE;AACjE,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoDvD;AA0BD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC5C,+BAA+B;IAC/B,OAAO,EAAE,IAAI,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACvC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,kDAAkD;IAClD,aAAa,EAAE,OAAO,EAAE,CAAC;CAC1B;AAED,gDAAgD;AAChD,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,mBAAmB,EAAE,GAC1B,iBAAiB,CAuDnB;AAYD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,qBAAqB,CAAC,GAAG,IAAI,GAAG,MAAM,GAAG,MAAM,CAWvG"}

package/dist/src/doctor/health/parser.js

@@ -0,0 +1,190 @@
+/**
+ * LLM 输出解析:JSON 提取 + dim_id 派发 + 容错。
+ *
+ * 流程:
+ *   1. extractJson 从 LLM 文本(可能带寒暄/code fence)抽出顶层 JSON。
+ *   2. 按 dim_id 把 checklist 项派发到 Map<dimId, HealthDimensionResult>。
+ *   3. 缺失维度(LLM 漏报)塞 _missing=true 的 placeholder,composer 据此 status=skipped。
+ *   4. 不合法 dim_id(LLM 编了 registry 之外的)直接丢弃。
+ *
+ * dimension_level_count / finding_count_by_level 由调用方 / renderer 自己算
+ * (LLM 算术不可靠,prompt 已声明不输出这两字段)。
+ */
+const REQUIRED_TOP_KEYS = new Set(['skill_name', 'checklist', 'summary']);
+/** 深度跟踪 brace,在 LLM 文本里找出顶层 JSON。多个候选时优先选含 ≥2 required key 的。 */
+export function extractJson(text) {
+    if (!text)
+        return null;
+    const candidates = [];
+    let pos = 0;
+    while (true) {
+        const start = text.indexOf('{', pos);
+        if (start === -1)
+            break;
+        let depth = 0;
+        let inString = false;
+        let escape = false;
+        let end = -1;
+        for (let i = start; i < text.length; i += 1) {
+            const c = text[i];
+            if (escape) {
+                escape = false;
+                continue;
+            }
+            if (inString) {
+                if (c === '\\')
+                    escape = true;
+                else if (c === '"')
+                    inString = false;
+                continue;
+            }
+            if (c === '"')
+                inString = true;
+            else if (c === '{')
+                depth += 1;
+            else if (c === '}') {
+                depth -= 1;
+                if (depth === 0) {
+                    end = i;
+                    break;
+                }
+            }
+        }
+        if (end === -1)
+            break;
+        const cand = text.slice(start, end + 1);
+        try {
+            const obj = JSON.parse(cand);
+            if (obj && typeof obj === 'object' && !Array.isArray(obj)) {
+                candidates.push({ text: cand, obj: obj });
+            }
+        }
+        catch {
+            // skip non-parseable; brace inside string is the common reason
+        }
+        pos = start + 1;
+    }
+    if (candidates.length === 0)
+        return null;
+    const strong = candidates.filter((c) => {
+        let hits = 0;
+        for (const k of REQUIRED_TOP_KEYS)
+            if (k in c.obj)
+                hits += 1;
+        return hits >= 2;
+    });
+    if (strong.length > 0) {
+        strong.sort((a, b) => b.text.length - a.text.length);
+        return strong[0].text;
+    }
+    const keyed = candidates.filter((c) => 'skill_name' in c.obj);
+    const pool = keyed.length > 0 ? keyed : candidates;
+    pool.sort((a, b) => b.text.length - a.text.length);
+    return pool[0].text;
+}
+// ---------------------------------------------------------------------------
+// Type guards & dispatch
+// ---------------------------------------------------------------------------
+function isDimLevel(s) {
+    return s === '健康' || s === '亚健康' || s === '不健康' || s === '不适用';
+}
+function isFindingLevel(s) {
+    return s === '错误' || s === '警告' || s === '建议';
+}
+function asFinding(raw) {
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const r = raw;
+    if (!isFindingLevel(r.level))
+        return null;
+    return {
+        level: r.level,
+        subtype: typeof r.subtype === 'string' ? r.subtype : '',
+        evidence: typeof r.evidence === 'string' ? r.evidence : '',
+        description: typeof r.description === 'string' ? r.description : '',
+    };
+}
+/** 从 cleaned JSON 字串(extractJson 的输出)派发到各维度。 */
+export function parseHealthOutput(jsonText, dims) {
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonText);
+    }
+    catch {
+        parsed = {};
+    }
+    const validIds = new Set(dims.map((d) => d.id));
+    const byDimId = new Map();
+    const checklist = Array.isArray(parsed.checklist) ? parsed.checklist : [];
+    for (const itemRaw of checklist) {
+        if (!itemRaw || typeof itemRaw !== 'object')
+            continue;
+        const item = itemRaw;
+        const dimId = item.dim_id;
+        if (typeof dimId !== 'string' || !validIds.has(dimId))
+            continue; // 容错:丢弃未注册 id
+        if (byDimId.has(dimId))
+            continue; // 容错:重复 id 取首条
+        const findingsRaw = Array.isArray(item.findings) ? item.findings : [];
+        const findings = [];
+        for (const fRaw of findingsRaw) {
+            const f = asFinding(fRaw);
+            if (f)
+                findings.push(f);
+        }
+        const suggestions = Array.isArray(item.suggestions)
+            ? item.suggestions.filter((s) => typeof s === 'string')
+            : [];
+        const level = isDimLevel(item.level)
+            ? item.level
+            : deriveDimLevel(findings);
+        byDimId.set(dimId, { level, findings, suggestions });
+    }
+    // 漏报维度填 placeholder
+    for (const dim of dims) {
+        if (!byDimId.has(dim.id)) {
+            byDimId.set(dim.id, { level: '不适用', findings: [], suggestions: [], _missing: true });
+        }
+    }
+    const summaryRaw = (parsed.summary && typeof parsed.summary === 'object'
+        ? parsed.summary
+        : {});
+    const validOveralls = new Set(['良好', '部分缺陷', '严重缺陷']);
+    const overallRaw = summaryRaw.overall_health;
+    const overall = typeof overallRaw === 'string' && validOveralls.has(overallRaw)
+        ? overallRaw
+        : null;
+    const topSuggestions = Array.isArray(summaryRaw.top_suggestions)
+        ? summaryRaw.top_suggestions.filter((s) => typeof s === 'string')
+        : [];
+    const featurePoints = Array.isArray(parsed.feature_points) ? parsed.feature_points : [];
+    return { byDimId, overall, topSuggestions, featurePoints };
+}
+// ---------------------------------------------------------------------------
+// Aggregation helpers
+// ---------------------------------------------------------------------------
+function deriveDimLevel(findings) {
+    if (findings.some((f) => f.level === '错误'))
+        return '不健康';
+    if (findings.length > 0)
+        return '亚健康';
+    return '健康';
+}
+export function deriveOverallHealth(byDimId) {
+    let hasUnhealthy = false;
+    let hasSubhealthy = false;
+    for (const r of byDimId.values()) {
+        if (r._missing)
+            continue; // 漏报不算
+        if (r.level === '不健康')
+            hasUnhealthy = true;
+        else if (r.level === '亚健康')
+            hasSubhealthy = true;
+    }
+    if (hasUnhealthy)
+        return '严重缺陷';
+    if (hasSubhealthy)
+        return '部分缺陷';
+    return '良好';
+}
+//# sourceMappingURL=parser.js.map

package/dist/src/doctor/health/parser.js.map

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

package/dist/src/doctor/health/prompt-builder.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 健康度体检 prompt 拼装器。
+ *
+ * 4 个区块:
+ *   Block 1: 任务说明 + skill 输入(固定)
+ *   Block 2: 检查维度章节(动态:遍历 dims,自动加 ## N. 标题 + (id: ...))
+ *   Block 3: 通用规则(同根因合并 / Finding level / 维度 level / overall_health)
+ *   Block 4: JSON schema(半动态:dim_id 枚举 + checklist 项数 = dims.length)
+ *
+ * 关键约束:LLM 用 dim_id(英文)在输出中标识维度,而不是中文 displayName —
+ * displayName 翻译/重命名时不会让 parser 崩。
+ */
+import type { HealthDimensionSpec } from './dimension-spec.js';
+export interface PromptInput {
+    skillName: string;
+    skillContent: string;
+    skillRoot: string | null;
+    subFiles: string[];
+    siblingSkills: string[];
+}
+export declare function buildHealthPrompt(input: PromptInput, dims: HealthDimensionSpec[]): string;
+//# sourceMappingURL=prompt-builder.d.ts.map

package/dist/src/doctor/health/prompt-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.d.ts","sourceRoot":"","sources":["../../../../src/doctor/health/prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,mBAAmB,EAAE,GAAG,MAAM,CAOzF"}

package/dist/src/doctor/health/prompt-builder.js

@@ -0,0 +1,162 @@
+/**
+ * 健康度体检 prompt 拼装器。
+ *
+ * 4 个区块:
+ *   Block 1: 任务说明 + skill 输入(固定)
+ *   Block 2: 检查维度章节(动态:遍历 dims,自动加 ## N. 标题 + (id: ...))
+ *   Block 3: 通用规则(同根因合并 / Finding level / 维度 level / overall_health)
+ *   Block 4: JSON schema(半动态:dim_id 枚举 + checklist 项数 = dims.length)
+ *
+ * 关键约束:LLM 用 dim_id(英文)在输出中标识维度,而不是中文 displayName —
+ * displayName 翻译/重命名时不会让 parser 崩。
+ */
+export function buildHealthPrompt(input, dims) {
+    return [
+        renderBlock1Header(input),
+        renderBlock2Dimensions(dims),
+        renderBlock3CommonRules(),
+        renderBlock4JsonSchema(input.skillName, dims),
+    ].join('\n\n');
+}
+// ---------------------------------------------------------------------------
+// Block 1: 任务 + skill 输入
+// ---------------------------------------------------------------------------
+function renderBlock1Header(input) {
+    const { skillName, skillContent, skillRoot, subFiles, siblingSkills } = input;
+    const siblingList = siblingSkills.length > 0
+        ? siblingSkills.map((s) => `\`${s}\``).join(', ')
+        : '(none)';
+    const subFilesList = subFiles.length > 0
+        ? subFiles.map((f) => `- ${f}`).join('\n')
+        : '(no sub-files; pure SKILL.md skill)';
+    const skillRootHint = skillRoot
+        ? `skill 根目录: \`${skillRoot}\`(子文件需要时用 Read 工具自取)`
+        : 'skill 是单文件 .md;没有子目录可 Read。';
+    return `你正在对 \`${skillName}\` 这个 skill 做**健康度体检**——按下面注册的所有维度逐一检查,给出 level、findings、改进建议。
+
+# 输入
+
+- skill 名: \`${skillName}\`
+- ${skillRootHint}
+- 子文件清单(仅参考,需要时用 Read 工具按路径自取):
+${subFilesList}
+
+# 系统 skill 列表(跨 skill 引用判断用)
+
+${siblingList}
+
+## SKILL.md 内容(已 inline,无需再 Read)
+
+\`\`\`markdown
+${skillContent}
+\`\`\``;
+}
+// ---------------------------------------------------------------------------
+// Block 2: 维度章节
+// ---------------------------------------------------------------------------
+function renderBlock2Dimensions(dims) {
+    const sections = dims.map((dim, idx) => {
+        const num = idx + 1;
+        return `## ${num}. ${dim.displayName} (id: \`${dim.id}\`)
+${dim.promptSection.trim()}`;
+    });
+    return `# 检查维度
+
+${sections.join('\n\n')}`;
+}
+// ---------------------------------------------------------------------------
+// Block 3: 通用规则
+// ---------------------------------------------------------------------------
+function renderBlock3CommonRules() {
+    return `# 同根因合并(去重规则)
+
+多个 finding 如果**根因相同 + 修复方式相同**,必须合并成**一条** finding(可以跨维度合并)。在 \`evidence\` 字段里把所有出现位置列全(用 \` ; \` 分隔),\`description\` 里点明"在 N 处出现"。
+
+合并后,该 finding 的 \`level\` 取所有出现位置中**最严重的一个**。\`suggestions\` 给统一修法。
+
+# Finding level 判定
+
+- \`错误\`:**必须修**。包括:
+  - 在**常见用户环境 / 默认安装方式 / 不同版本号下直接跑不通**(不只是"在文档作者机子上跑不通")
+  - 硬编码绝对路径含具体版本号 / 用户名 → 换环境必失败
+  - 引用了不存在的脚本 / CLI / MCP 工具 / skill
+  - 不可逆操作没有人工确认
+  - 指令严重歧义会让 LLM 在多次执行中跑出截然不同结果
+- \`警告\`:**应该修**。规范不符 / 可读性明显差 / 误触发风险但不会直接挂掉
+- \`建议\`:锦上添花
+
+# 维度 level 派生规则
+
+- \`健康\`:0 个 finding
+- \`亚健康\`:有警告 / 建议但无错误
+- \`不健康\`:至少 1 个错误
+- \`不适用\`:该维度对本 skill 无意义(谨慎使用,不要拿来回避检查)
+
+# overall_health
+
+- \`良好\`:所有维度都是 \`健康\` 或 \`不适用\`
+- \`部分缺陷\`:有 \`亚健康\` 但无 \`不健康\`
+- \`严重缺陷\`:任一维度 \`不健康\``;
+}
+// ---------------------------------------------------------------------------
+// Block 4: JSON schema
+// ---------------------------------------------------------------------------
+function renderBlock4JsonSchema(skillName, dims) {
+    const dimIdEnum = dims.map((d) => `"${d.id}"`).join(' | ');
+    const dimIdList = dims.map((d) => `\`${d.id}\``).join(', ');
+    return `# 输出 JSON schema
+
+输出**必须是单一合法 JSON 对象**。第一字符 \`{\`,最后 \`}\`,**不要**用 \`\`\`json\`\`\` 围栏,**不要**寒暄。
+
+{
+  "skill_name": "${skillName}",
+  "feature_points": [
+    {
+      "name": "<功能点名>",
+      "description": "<1-2 行>",
+      "simulation": [
+        {
+          "step": 1,
+          "action": "<这一步做什么>",
+          "input": "<参数>",
+          "simulated_output": "<假设返回值,**不真跑**>",
+          "derivable_from_doc": true,
+          "note": "<指令模糊处>"
+        }
+      ]
+    }
+  ],
+  "checklist": [
+    {
+      "dim_id": ${dimIdEnum},
+      "level": "健康 | 亚健康 | 不健康 | 不适用",
+      "findings": [
+        {
+          "level": "错误 | 警告 | 建议",
+          "subtype": "<仅 \`security\` 维度需填:不可逆操作 | 凭据硬编码 | 个人化耦合;其它维度留空字符串>",
+          "evidence": "<具体引用:SKILL.md L<行号> / 章节标题 / 文件名 / 功能点 X 第 Y 步>",
+          "description": "<一句话讲清问题>"
+        }
+      ],
+      "suggestions": ["<可执行的改进动作>"]
+    }
+  ],
+  "summary": {
+    "overall_health": "良好 | 部分缺陷 | 严重缺陷",
+    "top_suggestions": ["<整 skill 视角下最该先改的 3 条,按优先级从高到低>"]
+  }
+}
+
+# 字段约束
+
+- \`checklist\` 必须**恰好包含 ${dims.length} 项**,\`dim_id\` 必须是以下之一,**每个 id 出现且仅出现一次**:
+  ${dimIdList}
+- \`level\` / \`subtype\` 字段值用精确中文字符串,不允许英文或别名
+- \`evidence\` 必须有具体引用,不能笼统说"全文"
+- 字符串里的 skill / 文件 / 命令名用反引号 \`xxx\` 包裹
+- **不要**冒虚假 finding,宁可少报也不要把"看起来可能有问题"硬塞进来
+- 不要输出 \`dimension_level_count\` / \`finding_count_by_level\` 字段(框架自己重算)
+
+读 SKILL.md(已 inline)→ 模拟执行 → 出 JSON。`;
+}
+//# sourceMappingURL=prompt-builder.js.map

package/dist/src/doctor/health/prompt-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-builder.js","sourceRoot":"","sources":["../../../../src/doctor/health/prompt-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAYH,MAAM,UAAU,iBAAiB,CAAC,KAAkB,EAAE,IAA2B;IAC/E,OAAO;QACL,kBAAkB,CAAC,KAAK,CAAC;QACzB,sBAAsB,CAAC,IAAI,CAAC;QAC5B,uBAAuB,EAAE;QACzB,sBAAsB,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,CAAC;KAC9C,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AACjB,CAAC;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,SAAS,kBAAkB,CAAC,KAAkB;IAC5C,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;IAC9E,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,GAAG,CAAC;QAC1C,CAAC,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACjD,CAAC,CAAC,QAAQ,CAAC;IACb,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC;QACtC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC1C,CAAC,CAAC,qCAAqC,CAAC;IAC1C,MAAM,aAAa,GAAG,SAAS;QAC7B,CAAC,CAAC,gBAAgB,SAAS,uBAAuB;QAClD,CAAC,CAAC,6BAA6B,CAAC;IAElC,OAAO,UAAU,SAAS;;;;eAIb,SAAS;IACpB,aAAa;;EAEf,YAAY;;;;EAIZ,WAAW;;;;;EAKX,YAAY;OACP,CAAC;AACR,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,SAAS,sBAAsB,CAAC,IAA2B;IACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;QACrC,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC;QACpB,OAAO,MAAM,GAAG,KAAK,GAAG,CAAC,WAAW,WAAW,GAAG,CAAC,EAAE;EACvD,GAAG,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC;IAC3B,CAAC,CAAC,CAAC;IACH,OAAO;;EAEP,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,SAAS,uBAAuB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBA4Be,CAAC;AACzB,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,SAAS,sBAAsB,CAAC,SAAiB,EAAE,IAA2B;IAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE5D,OAAO;;;;;mBAKU,SAAS;;;;;;;;;;;;;;;;;;;kBAmBV,SAAS;;;;;;;;;;;;;;;;;;;;;2BAqBA,IAAI,CAAC,MAAM;IAClC,SAAS;;;;;;;qCAOwB,CAAC;AACtC,CAAC"}

package/dist/src/doctor/health/register.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 副作用入口:把 7 个内置维度注册到 dimensionRegistry,把 composer rule
+ * 注册到 doctor customRules。
+ *
+ * CLI doctor.ts 默认动态 import 本文件 → 副作用一次性完成。
+ * `--static-only` 会在 CLI 层过滤掉 composer rule,不触发 LLM 审计。
+ * 测试 import 各 module 的具名 export 不会触发本文件,保持 registry 干净。
+ *
+ * 用户自定义维度:在自己的代码里 `registerHealthDimension(spec)`,只要在
+ * composer 跑之前注册即可(eg. 在 omk 配置 / plugin 入口里)。
+ */
+export {};
+//# sourceMappingURL=register.d.ts.map

package/dist/src/doctor/health/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../../src/doctor/health/register.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}

package/dist/src/doctor/health/register.js

@@ -0,0 +1,20 @@
+/**
+ * 副作用入口:把 7 个内置维度注册到 dimensionRegistry,把 composer rule
+ * 注册到 doctor customRules。
+ *
+ * CLI doctor.ts 默认动态 import 本文件 → 副作用一次性完成。
+ * `--static-only` 会在 CLI 层过滤掉 composer rule,不触发 LLM 审计。
+ * 测试 import 各 module 的具名 export 不会触发本文件,保持 registry 干净。
+ *
+ * 用户自定义维度:在自己的代码里 `registerHealthDimension(spec)`,只要在
+ * composer 跑之前注册即可(eg. 在 omk 配置 / plugin 入口里)。
+ */
+import { registerRule } from '../rules.js';
+import { BUILTIN_HEALTH_DIMENSIONS } from './builtin-dimensions.js';
+import { registerHealthDimension } from './dimension-registry.js';
+import { makeSkillHealthComposer } from './composer.js';
+for (const spec of BUILTIN_HEALTH_DIMENSIONS) {
+    registerHealthDimension(spec);
+}
+registerRule(makeSkillHealthComposer());
+//# sourceMappingURL=register.js.map

package/dist/src/doctor/health/register.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.js","sourceRoot":"","sources":["../../../../src/doctor/health/register.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD,KAAK,MAAM,IAAI,IAAI,yBAAyB,EAAE,CAAC;IAC7C,uBAAuB,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AACD,YAAY,CAAC,uBAAuB,EAAE,CAAC,CAAC"}

package/dist/src/doctor/html-renderer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * doctor HTML 报告渲染器。
+ *
+ * 输出 single-file HTML(JSON inline,CSS/JS 内嵌,无外部依赖),双击可看,
+ * 不需 http server。专为 LLM 健康度审计报告设计 — 重点展示 composer group 内的
+ * 维度结果,但也兼容显示静态 rule 段。
+ *
+ * 排序约定:
+ *   - 维度卡片按 fail → warn → pass → skipped(STATUS_RANK)排
+ *   - 每个维度卡片内的 finding 按 错误 → 警告 → 建议 排
+ *   - skill 级别按 outcome (failed / warnings_only / passed) 排
+ *
+ * 前端交互:
+ *   - 顶部 filter pills:全部 / 仅失败 / 仅警告 / 仅通过 — 切换时 dim card 显隐
+ *   - 维度卡片头部点击折叠/展开 findings 区
+ */
+import type { DoctorReport } from '../types/index.js';
+import { type CliLang } from '../cli/i18n.js';
+export declare function renderDoctorReportHtml(report: DoctorReport, lang?: CliLang): string;
+//# sourceMappingURL=html-renderer.d.ts.map

package/dist/src/doctor/html-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-renderer.d.ts","sourceRoot":"","sources":["../../../src/doctor/html-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,YAAY,EAGb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAQ,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAsVpD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,GAAE,OAAc,GAAG,MAAM,CA0BzF"}