oh-my-knowledge 0.26.0 → 0.28.0

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

@@ -0,0 +1,289 @@
+/**
+ * skill_health composer rule — 健康度体检的"复合 rule"。
+ *
+ * 单次 LLM 调用产出全部已注册维度的 checklist;composer.checkAll() 返回 N+1 条
+ * outcome:N = 注册维度数(每维一条),1 = summary(top_suggestions / overall_health
+ * / feature_points 落在这条)。
+ *
+ * doctor engine 检测 kind='composer' 时把 outcome[] 展开成 N+1 条独立 DoctorRuleResult,
+ * 共享 groupId = composer.id,renderer 按 groupId 分组渲染。
+ *
+ * 工厂模式 makeSkillHealthComposer(execFactory) 给测试注入 mock executor。
+ * 默认 import 时不注册;register.ts 才做 registerRule 副作用。
+ */
+import { existsSync, readdirSync, statSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { tCli } from '../../cli/i18n.js';
+import { createExecutor } from '../../executors/index.js';
+import { getRegisteredHealthDimensions } from './dimension-registry.js';
+import { buildHealthPrompt } from './prompt-builder.js';
+import { deriveOverallHealth, extractJson, parseHealthOutput } from './parser.js';
+export const SKILL_HEALTH_COMPOSER_ID = 'skill_health';
+const defaultExecutorFactory = createExecutor;
+// ---------------------------------------------------------------------------
+// Status mapping
+// ---------------------------------------------------------------------------
+function mapDimLevelToStatus(level, missing) {
+    if (missing)
+        return 'skipped';
+    switch (level) {
+        case '不健康': return 'fail';
+        case '亚健康': return 'warn';
+        case '健康': return 'pass';
+        case '不适用': return 'skipped';
+    }
+}
+// ---------------------------------------------------------------------------
+// Per-dim outcome rendering
+// ---------------------------------------------------------------------------
+function dimMessage(dim, r, lang) {
+    if (r._missing) {
+        return tCli('cli.doctor.health.dim.missing', lang, { dim: dim.displayName });
+    }
+    const errs = r.findings.filter((f) => f.level === '错误').length;
+    const warns = r.findings.filter((f) => f.level === '警告').length;
+    const sugs = r.findings.filter((f) => f.level === '建议').length;
+    return tCli('cli.doctor.health.dim.message', lang, {
+        level: r.level, err: errs, warn: warns, sug: sugs,
+    });
+}
+function dimHint(r) {
+    if (r.suggestions.length === 0)
+        return undefined;
+    return r.suggestions[0];
+}
+// ---------------------------------------------------------------------------
+// Sub-files / siblings discovery (与上一版本相同)
+// ---------------------------------------------------------------------------
+function listSubFiles(skillRoot) {
+    if (!skillRoot || !existsSync(skillRoot))
+        return [];
+    const out = [];
+    const walk = (dir, rel, depth) => {
+        if (depth > 2)
+            return;
+        let entries = [];
+        try {
+            entries = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            if (entry.startsWith('.'))
+                continue;
+            if (entry === 'SKILL.md' && rel === '')
+                continue;
+            if (entry === 'node_modules')
+                continue;
+            const full = join(dir, entry);
+            const relPath = rel ? `${rel}/${entry}` : entry;
+            let st;
+            try {
+                st = statSync(full);
+            }
+            catch {
+                continue;
+            }
+            if (st.isDirectory())
+                walk(full, relPath, depth + 1);
+            else if (st.isFile())
+                out.push(relPath);
+        }
+    };
+    walk(skillRoot, '', 0);
+    return out.sort();
+}
+function listSiblingSkills(skillRoot) {
+    if (!skillRoot || !existsSync(skillRoot))
+        return [];
+    const parent = dirname(skillRoot);
+    if (!existsSync(parent))
+        return [];
+    const self = skillRoot.split('/').pop() ?? '';
+    let entries = [];
+    try {
+        entries = readdirSync(parent);
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter((e) => !e.startsWith('.') && e !== self)
+        .filter((e) => {
+        try {
+            return statSync(join(parent, e)).isDirectory();
+        }
+        catch {
+            return false;
+        }
+    })
+        .sort();
+}
+// ---------------------------------------------------------------------------
+// Composer factory
+// ---------------------------------------------------------------------------
+export function makeSkillHealthComposer(execFactory = defaultExecutorFactory) {
+    return {
+        id: SKILL_HEALTH_COMPOSER_ID,
+        kind: 'composer',
+        severity: 'fatal',
+        labelKey: 'cli.doctor.rule.skill_health_check',
+        checkAll: (ctx) => composerCheckAll(ctx, execFactory),
+    };
+}
+async function composerCheckAll(ctx, execFactory) {
+    const dims = getRegisteredHealthDimensions();
+    // Programmatic opt-out: runHealthCheck=false → 给 summary 一条 skipped,
+    // 各维度不展开避免污染报告。CLI 的 --static-only 会直接过滤掉 composer rule。
+    if (!ctx.runHealthCheck) {
+        return [{
+                subId: '_summary',
+                severity: 'info',
+                labelKey: 'cli.doctor.rule.skill_health_check',
+                status: 'skipped',
+                message: tCli('cli.doctor.health.skipped', ctx.lang),
+            }];
+    }
+    // 没注册任何维度 → 短路
+    if (dims.length === 0) {
+        return [{
+                subId: '_summary',
+                severity: 'info',
+                labelKey: 'cli.doctor.rule.skill_health_check',
+                status: 'skipped',
+                message: tCli('cli.doctor.health.no_dimensions', ctx.lang),
+            }];
+    }
+    const content = ctx.artifact.content;
+    if (!content || content.trim().length === 0) {
+        // skill_readable rule 也会 fail;这里只是 short-circuit 防止白白调 LLM
+        return [{
+                subId: '_summary',
+                severity: 'info',
+                labelKey: 'cli.doctor.rule.skill_health_check',
+                status: 'skipped',
+                message: tCli('cli.doctor.health.skipped', ctx.lang),
+            }];
+    }
+    const skillName = ctx.artifact.name.replace(/\.md$/, '').split('/').pop() ?? ctx.artifact.name;
+    const skillRoot = ctx.artifact.skillRoot ?? null;
+    const subFiles = listSubFiles(skillRoot);
+    const siblingSkills = listSiblingSkills(skillRoot);
+    const prompt = buildHealthPrompt({ skillName, skillContent: content, skillRoot, subFiles, siblingSkills }, dims);
+    const executor = execFactory(ctx.executorName);
+    let res;
+    try {
+        res = await executor({
+            model: ctx.model,
+            prompt,
+            cwd: skillRoot ?? ctx.cwd,
+            skillDir: skillRoot ?? null,
+            timeoutMs: ctx.timeoutMs,
+        });
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return [errorSummaryOutcome(ctx, 'executor', msg)];
+    }
+    if (!res.ok) {
+        return [errorSummaryOutcome(ctx, 'executor', res.error ?? 'unknown')];
+    }
+    if (!res.output || res.output.trim().length === 0) {
+        return [errorSummaryOutcome(ctx, 'empty_output', '')];
+    }
+    const cleaned = extractJson(res.output);
+    if (cleaned === null) {
+        return [errorSummaryOutcome(ctx, 'extract', '', { rawOutput: res.output.slice(0, 4000) })];
+    }
+    const parseResult = parseHealthOutput(cleaned, dims);
+    const overall = parseResult.overall ?? deriveOverallHealth(parseResult.byDimId);
+    // 诊断:如果所有维度都被标 _missing,说明 LLM 输出 JSON 里 dim_id 字段缺失或写错。
+    // 把 cleaned JSON 的前 3KB 塞进 summary 的 detail.rawSample,方便用户排查。
+    const allMissing = [...parseResult.byDimId.values()].every((r) => r._missing);
+    const rawSample = allMissing ? cleaned.slice(0, 3000) : undefined;
+    // 汇总 finding 计数(框架算,不信 LLM 算术)
+    const finding = { '错误': 0, '警告': 0, '建议': 0 };
+    const dimCount = { '健康': 0, '亚健康': 0, '不健康': 0, '不适用': 0 };
+    for (const r of parseResult.byDimId.values()) {
+        if (r._missing)
+            continue;
+        dimCount[r.level] += 1;
+        for (const f of r.findings)
+            finding[f.level] += 1;
+    }
+    // N 条维度 outcome
+    const dimOutcomes = dims.map((dim) => {
+        const r = parseResult.byDimId.get(dim.id);
+        return {
+            subId: dim.id,
+            labelKey: dim.labelKey,
+            severity: dim.severity,
+            status: mapDimLevelToStatus(r.level, r._missing),
+            message: dimMessage(dim, r, ctx.lang),
+            hint: dimHint(r),
+            detail: {
+                dimensionId: dim.id,
+                displayName: dim.displayName,
+                level: r.level,
+                findings: r.findings,
+                suggestions: r.suggestions,
+                missing: r._missing ?? false,
+            },
+        };
+    });
+    // 1 条 summary outcome
+    const summaryOutcome = {
+        subId: '_summary',
+        severity: 'info',
+        labelKey: 'cli.doctor.health.summary.label',
+        status: 'pass', // summary 永远 pass(信息性,不影响 outcome)
+        message: tCli('cli.doctor.health.summary.message', ctx.lang, {
+            overall,
+            h: dimCount['健康'], sh: dimCount['亚健康'], bad: dimCount['不健康'], na: dimCount['不适用'],
+            err: finding['错误'], warn: finding['警告'], sug: finding['建议'],
+        }),
+        hint: parseResult.topSuggestions.slice(0, 3).join(' | ')
+            || tCli('cli.doctor.health.summary.no_top', ctx.lang),
+        detail: {
+            overall,
+            dimensionLevelCount: dimCount,
+            findingCountByLevel: finding,
+            topSuggestions: parseResult.topSuggestions,
+            featurePoints: parseResult.featurePoints,
+            durationMs: res.durationMs,
+            durationApiMs: res.durationApiMs,
+            // turns:claude-cli 在内部跑的 LLM 轮次(每轮 = 1 次 messages.create)
+            // numTurns:assistant turn 数 / fullNumTurns:含 tool turn 的总数
+            llmTurns: { numTurns: res.numTurns, fullNumTurns: res.fullNumTurns },
+            tokens: {
+                input: res.inputTokens, output: res.outputTokens,
+                cacheRead: res.cacheReadTokens, cacheCreation: res.cacheCreationTokens,
+            },
+            costUSD: res.costUSD,
+            executor: { name: ctx.executorName, model: ctx.model },
+            ...(rawSample !== undefined ? { rawSample, _diagnostic: 'all dims missing — likely dim_id field absent in LLM output' } : {}),
+        },
+    };
+    return [...dimOutcomes, summaryOutcome];
+}
+function errorSummaryOutcome(ctx, phase, errMsg, extra = {}) {
+    const messageKey = phase === 'executor'
+        ? 'cli.doctor.health.fail.executor'
+        : phase === 'empty_output'
+            ? 'cli.doctor.health.fail.empty_output'
+            : 'cli.doctor.health.fail.parse';
+    const hintKey = phase === 'executor'
+        ? 'cli.doctor.health.hint.executor'
+        : 'cli.doctor.health.hint.parse';
+    return {
+        subId: '_summary',
+        severity: 'fatal',
+        labelKey: 'cli.doctor.health.summary.label',
+        status: 'fail',
+        message: tCli(messageKey, ctx.lang, { error: errMsg.slice(0, 200) }),
+        hint: tCli(hintKey, ctx.lang),
+        detail: { phase, error: errMsg, ...extra },
+    };
+}
+//# sourceMappingURL=composer.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * HealthDimensionSpec 全局注册表(module-level singleton)。
+ *
+ * 内置 7 个维度由 health/register.ts 注册;用户通过 registerHealthDimension()
+ * 注册自定义维度。注册顺序就是 prompt 中的章节编号顺序。
+ *
+ * id 冲突会抛 — 防止意外覆盖。__resetForTest 给单测用。
+ */
+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

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

@@ -0,0 +1 @@
+{"version":3,"file":"dimension-registry.d.ts","sourceRoot":"","sources":["../../../../src/doctor/health/dimension-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAK/D,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,mBAAmB,GAAG,IAAI,CASvE;AAED,wBAAgB,6BAA6B,IAAI,mBAAmB,EAAE,CAErE;AAED,wBAAgB,8BAA8B,IAAI,IAAI,CAGrD"}

package/dist/src/doctor/health/dimension-registry.js

@@ -0,0 +1,28 @@
+/**
+ * HealthDimensionSpec 全局注册表(module-level singleton)。
+ *
+ * 内置 7 个维度由 health/register.ts 注册;用户通过 registerHealthDimension()
+ * 注册自定义维度。注册顺序就是 prompt 中的章节编号顺序。
+ *
+ * id 冲突会抛 — 防止意外覆盖。__resetForTest 给单测用。
+ */
+const dimensions = [];
+const seenIds = new Set();
+export function registerHealthDimension(spec) {
+    if (!spec.id || spec.id.includes(':')) {
+        throw new Error(`invalid health dimension id: "${spec.id}" (non-empty, no ":")`);
+    }
+    if (seenIds.has(spec.id)) {
+        throw new Error(`health dimension id collision: ${spec.id}`);
+    }
+    seenIds.add(spec.id);
+    dimensions.push(spec);
+}
+export function getRegisteredHealthDimensions() {
+    return [...dimensions]; // 防止外部 mutate
+}
+export function __resetHealthDimensionsForTest() {
+    dimensions.length = 0;
+    seenIds.clear();
+}
+//# sourceMappingURL=dimension-registry.js.map

package/dist/src/doctor/health/dimension-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimension-registry.js","sourceRoot":"","sources":["../../../../src/doctor/health/dimension-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,MAAM,UAAU,GAA0B,EAAE,CAAC;AAC7C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;AAElC,MAAM,UAAU,uBAAuB,CAAC,IAAyB;IAC/D,IAAI,CAAC,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,EAAE,uBAAuB,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACrB,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,cAAc;AACxC,CAAC;AAED,MAAM,UAAU,8BAA8B;IAC5C,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IACtB,OAAO,CAAC,KAAK,EAAE,CAAC;AAClB,CAAC"}

package/dist/src/doctor/health/dimension-spec.d.ts

@@ -0,0 +1,46 @@
+/**
+ * HealthDimensionSpec — 健康度维度的可扩展接口。
+ *
+ * 用户写一个 spec 描述自己想加的维度,通过 registerHealthDimension(spec) 注册;
+ * composer 在拼 prompt 时把所有注册的 spec 的 promptSection 拼进"检查维度"区块,
+ * 同时把 spec.id 加入 dim_id 枚举,LLM 必须在 checklist 中按每个 id 出一项。
+ *
+ * 维度结果(level + findings)的解析按统一规则跑;若维度需要特殊解析(eg. 把
+ * subtype 作为 finding 一级字段),后续可以加可选 hooks(parseFindings 等)。
+ */
+import type { DoctorSeverity } from '../../types/doctor.js';
+export type HealthDimensionLevel = '健康' | '亚健康' | '不健康' | '不适用';
+export type HealthFindingLevel = '错误' | '警告' | '建议';
+export interface HealthFinding {
+    level: HealthFindingLevel;
+    /** 仅 security 维度填(`不可逆操作 | 凭据硬编码 | 个人化耦合`),其它维度空字符串。
+     *  保留为通用字段,未来其它维度也可借此做子分类。 */
+    subtype?: string;
+    evidence: string;
+    description: string;
+}
+export interface HealthDimensionResult {
+    level: HealthDimensionLevel;
+    findings: HealthFinding[];
+    suggestions: string[];
+    /** 内部标记:LLM 没产出该维度时,parser 会塞一个 placeholder + _missing=true,
+     *  composer 据此把 status 置为 skipped + message 提示 LLM 漏报。 */
+    _missing?: boolean;
+}
+export interface HealthDimensionSpec {
+    /** 稳定的英文 id。会成为 prompt 里 dim_id 的取值,以及 ruleId 后缀。
+     *  不允许重复;不允许包含 `:`(避免和 composer ruleId 分隔符冲突)。 */
+    id: string;
+    /** 给人看的简短显示名(LLM prompt 里的章节标题用 + renderer 用)。
+     *  可以是中文或多语言混用,稳定性不重要(因为 LLM 通过 id 派发,不看 displayName)。 */
+    displayName: string;
+    /** i18n key,doctor result 的 labelKey 用。renderer 走 tCli 出最终标题。 */
+    labelKey: string;
+    /** 该维度的严重度。`不健康` → fail 时,severity=fatal 才会让 doctor outcome 进 `failed`。
+     *  内置 7 维度按重要性区分(eg. dependency/security 是 fatal, doc-clarity 是 warn)。 */
+    severity: DoctorSeverity;
+    /** 拼到 prompt 的检查内容片段(纯 markdown,**不写 ## N. 标题** —— 框架自动加章节号)。
+     *  描述这一维度查什么、判定标准、example。 */
+    promptSection: string;
+}
+//# sourceMappingURL=dimension-spec.d.ts.map

package/dist/src/doctor/health/dimension-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimension-spec.d.ts","sourceRoot":"","sources":["../../../../src/doctor/health/dimension-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE5D,MAAM,MAAM,oBAAoB,GAAG,IAAI,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAChE,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,kBAAkB,CAAC;IAC1B;kCAC8B;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,oBAAoB,CAAC;IAC5B,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB;8DAC0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC;sDACkD;IAClD,EAAE,EAAE,MAAM,CAAC;IACX;8DAC0D;IAC1D,WAAW,EAAE,MAAM,CAAC;IACpB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;IACjB;8EAC0E;IAC1E,QAAQ,EAAE,cAAc,CAAC;IACzB;kCAC8B;IAC9B,aAAa,EAAE,MAAM,CAAC;CACvB"}

package/dist/src/doctor/health/dimension-spec.js

@@ -0,0 +1,12 @@
+/**
+ * HealthDimensionSpec — 健康度维度的可扩展接口。
+ *
+ * 用户写一个 spec 描述自己想加的维度,通过 registerHealthDimension(spec) 注册;
+ * composer 在拼 prompt 时把所有注册的 spec 的 promptSection 拼进"检查维度"区块,
+ * 同时把 spec.id 加入 dim_id 枚举,LLM 必须在 checklist 中按每个 id 出一项。
+ *
+ * 维度结果(level + findings)的解析按统一规则跑;若维度需要特殊解析(eg. 把
+ * subtype 作为 finding 一级字段),后续可以加可选 hooks(parseFindings 等)。
+ */
+export {};
+//# sourceMappingURL=dimension-spec.js.map

package/dist/src/doctor/health/dimension-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dimension-spec.js","sourceRoot":"","sources":["../../../../src/doctor/health/dimension-spec.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

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