dsh-data-domain-knowledge 0.1.0-alpha.1

package/lib/types/diagnosis/store.js

@@ -0,0 +1,409 @@
+import { mkdir, readFile, readdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { SEED_CASES, SEED_GRAPH } from './seed.js';
+import { seedSources } from './seed-source.js';
+import { DIAGNOSIS_ENTITIES, templateCard, validateDiagnosis } from './schema.js';
+import { cardsToGraph, cardPathOf, graphToCards, parseCard, serializeCard, RUN_EDGE_KINDS, } from './cards.js';
+/**
+ * `05_diagnosis/` 的落盘与读取（v0.7 起：**卡片才是真相，这里只放一次排查的产物**）。
+ *
+ * ## 为什么要改
+ *
+ * 改版前这里同时扮演两个角色：既是 seed 写出来的 jsonl 数据集，又被当成图的唯一来源。
+ * 后果是排查思路**从来没进过 wiki** —— 不在 `01_source_truth`、不是 `02_wiki` 的卡片、
+ * 编译器不认它的 entity_type，于是不会被 wikiNote 化、不会进向量索引，**永远召不回来**。
+ * 而 `store.ts` 顶上那句「全部内容都能从 wiki 卡片确定性重建」描述的其实是目标状态，
+ * 代码走的是相反的路径。
+ *
+ * ## 现在的分工
+ *
+ * | 目录 | 内容 | 谁是真相 |
+ * | --- | --- | --- |
+ * | `01_source_truth/` | 手册与复盘原文（`sourceType=question`） | 人写的原始材料 |
+ * | `02_wiki/diagnosis/` | 五类卡片（三段式） | **知识侧的唯一真相** |
+ * | `05_diagnosis/` | `evidence` / `cause` / 执行边（`produces` `supports` `refutes` `confirmed_as`）与模板卡 | 一次排查的产物 |
+ *
+ * 读取顺序是显式的：**有卡片就编译卡片；没有卡片但有旧 jsonl 就按旧格式读出来（并尝试
+ * 前向迁移）；两者都没有才灌 seed**。老知识根不会因为这次改动而读不出内容。
+ */
+const DIR = '05_diagnosis';
+/** 一次排查写下的节点：它们不是知识，所以留在这里，不进卡片。 */
+const RUN_NODE_SHARDS = {
+    'evidence.jsonl': 'evidence',
+    'causes.jsonl': 'cause',
+};
+/**
+ * 旧版的类型层分片。**只读，不再写**：v0.7 之前它们就是真相，现在它们的角色是
+ * 「迁移输入 + 历史快照」。迁移成功后内容已经在卡片里，这些文件保持原样以便追溯。
+ */
+const LEGACY_SHARDS = {
+    'symptoms.jsonl': 'symptom',
+    'hypotheses.jsonl': 'hypothesis',
+    'checks.jsonl': 'check',
+    'failure-modes.jsonl': 'failure-mode',
+    'assets.jsonl': 'asset',
+    'cases.jsonl': 'case',
+};
+const README = `# 05_diagnosis
+
+这个目录**只放一次排查的产物**（\`evidence\` / \`cause\` / 执行边），以及新人照抄的模板卡。
+
+排查思路本身（现象 / 假设 / 检查 / 失败模式 / 案例）现在是 **wiki 卡片**，住在
+\`02_wiki/diagnosis/\`，出处是 \`01_source_truth/\` 里的手册与复盘。图由卡片编译而来 ——
+所以改知识要改卡片（或改它的来源文档再重新编译），不要改这里。
+
+\`*.jsonl\` 里若出现 \`symptoms\` / \`hypotheses\` / \`checks\` / \`failure-modes\` / \`assets\`
+等分片，那是 v0.7 之前的历史快照：版本升级时被读出来迁移成了卡片，之后不再更新。
+`;
+export class DiagnosisStore {
+    host;
+    constructor(host) {
+        this.host = host;
+    }
+    get dir() { return join(this.host.rootDir, DIR); }
+    get cardsDir() { return join(this.host.rootDir, '02_wiki', 'diagnosis'); }
+    /**
+     * 幂等初始化。三种状态各自处理，互不覆盖：
+     *
+     * 1. 已有卡片 → 什么都不做（卡片是真相，人可能刚改过）；
+     * 2. 没有卡片但有旧 jsonl → **前向迁移**：把旧图反推成卡片写出去，并**校验迁移无损**
+     *    （重新编译一遍与旧图比对，不一致就不认这次迁移，继续按 jsonl 读 —— 宁可留在旧形态，
+     *    也不要静默丢知识）；
+     * 3. 两者都没有 → 首次启动：先落手册与复盘的 SourceRaw，再把 seed 编译成卡片。
+     */
+    async ensure() {
+        await mkdir(this.dir, { recursive: true });
+        const templates = join(this.dir, 'templates');
+        await mkdir(templates, { recursive: true });
+        await Promise.all(DIAGNOSIS_ENTITIES.map(spec => this.writeIfAbsent(join(templates, `${spec.entityType.replace(/\//g, '-')}.md`), templateCard(spec))));
+        // 目录角色的说明也要落盘：下一个人只打开 05_diagnosis 时，得知道知识已经搬走了。
+        await this.writeIfAbsent(join(this.dir, 'README.md'), README);
+        // 注意：**不要**在这里为一次排查的产物建空占位文件。它们走 `writeIfAbsent`，
+        // 而「占位」会在首次 seed 之前就把文件创建出来，于是 seed 的真实内容被判为「已存在」
+        // 而写不进去 —— 结果是图上少了 evidence / cause 五个节点，且没有任何报错。
+        if ((await this.readCards()).length > 0)
+            return { seeded: false, migrated: false, problems: [] };
+        if ((await this.legacyShardFiles()).length > 0)
+            return await this.migrate();
+        return await this.seed();
+    }
+    async snapshot() {
+        const { seeded, migrated, problems } = await this.ensure();
+        const cards = await this.readCards();
+        const run = await this.readRunArtifacts();
+        if (cards.length > 0) {
+            const compiled = cardsToGraph(cards);
+            const graph = {
+                nodes: [...compiled.graph.nodes, ...run.nodes],
+                edges: [...compiled.graph.edges, ...run.edges],
+            };
+            return {
+                graph,
+                cases: compiled.cases,
+                issues: validateDiagnosis(graph),
+                seeded,
+                migrated,
+                source: 'cards',
+                problems: [...problems, ...compiled.problems],
+            };
+        }
+        // 还没有卡片：旧 jsonl（或 seed 刚写下的那份）就是当前可读的来源。
+        const graph = await this.readGraph();
+        const cases = await this.readCases();
+        return {
+            graph,
+            cases,
+            issues: validateDiagnosis(graph),
+            seeded,
+            migrated,
+            source: (await this.legacyShardFiles()).length > 0 ? 'jsonl' : 'seed',
+            problems,
+        };
+    }
+    /**
+     * 图。
+     *
+     * 有卡片：`cardsToGraph(卡片)` + 一次排查的产物；没有卡片：按旧 jsonl 读。
+     * 两条路径都返回同一种形状，调用方不需要知道现在是哪一代。
+     */
+    async readGraph() {
+        const cards = await this.readCards();
+        if (cards.length > 0) {
+            const compiled = cardsToGraph(cards);
+            const run = await this.readRunArtifacts();
+            return { nodes: [...compiled.graph.nodes, ...run.nodes], edges: [...compiled.graph.edges, ...run.edges] };
+        }
+        return await this.readLegacyGraph();
+    }
+    async readCases() {
+        const cards = await this.readCards();
+        if (cards.length > 0)
+            return cardsToGraph(cards).cases;
+        try {
+            const raw = await readFile(join(this.dir, 'cases.json'), 'utf8');
+            const parsed = JSON.parse(raw);
+            return Array.isArray(parsed) ? parsed : [];
+        }
+        catch {
+            return [];
+        }
+    }
+    /* ────────────────────────────────────────────── 卡片：读写 ── */
+    /** 读 `02_wiki/diagnosis/**` 下的全部卡片。解析不出来的文件按「不是卡片」跳过。 */
+    async readCards() {
+        const cards = [];
+        for (const file of await walkMarkdown(this.cardsDir)) {
+            const card = parseCard(await readFile(file, 'utf8'));
+            if (card)
+                cards.push(card);
+        }
+        return cards;
+    }
+    /** 写一批卡片。返回写失败的原因（schema 不认、出处不存在等），由调用方决定怎么显示。 */
+    async writeCards(cards) {
+        const problems = [];
+        for (const card of cards) {
+            const written = await this.host.writeCard({
+                entityType: card.entityType,
+                entityId: card.entityId,
+                title: card.title,
+                content: renderBody(card),
+                sourceRefs: card.sourceRefs,
+                status: card.status,
+                ...(card.summary ? { summary: card.summary } : {}),
+                ...(card.owner ? { owner: card.owner } : {}),
+            });
+            if (written.ok === false)
+                problems.push(`卡片 ${card.entityId} 写入失败：${written.error.code} ${written.error.message}`);
+        }
+        return problems;
+    }
+    /* ────────────────────────────────────────────── 首次 seed ── */
+    async seed() {
+        const { problems: sourceProblems, refs } = await this.writeSources(seedSources());
+        const cards = withSourceRefs(graphToCards(SEED_GRAPH, SEED_CASES), refs, SEED_GRAPH, SEED_CASES);
+        const problems = [...sourceProblems, ...await this.writeCards(cards)];
+        // 一次排查的产物照旧落在这里 —— seed 本来就等于「已经发生过的那三次排查」。
+        await this.writeRunArtifacts(SEED_GRAPH);
+        await this.writeLegacySnapshot();
+        return { seeded: true, migrated: false, problems };
+    }
+    /* ────────────────────────────────────────────── 旧知识根迁移 ── */
+    async migrate() {
+        const legacy = await this.readLegacyGraph();
+        const cases = await this.readCases();
+        // **先在内存里验证，通过才写盘。**
+        //
+        // 卡片表达不了的东西确实存在：手工加的边、没有任何假设引用的资产节点……一旦迁移会丢，
+        // 就宁可留在旧形态，也不要静默丢知识。而「先写再验、失败回滚」会留一个更糟的中间态：
+        // 卡片已经落盘，下一次读就成了卡片来源 —— 于是分歧只在第一次读时被报出来，
+        // 之后再也看不见。所以顺序是：编译 → 比对 → 才写。
+        const run = await this.readRunArtifacts();
+        const draft = graphToCards(legacy, cases);
+        const compiled = cardsToGraph(draft);
+        const divergence = compareGraphs(legacy, {
+            nodes: [...compiled.graph.nodes, ...run.nodes],
+            edges: [...compiled.graph.edges, ...run.edges],
+        });
+        if (divergence) {
+            return { seeded: false, migrated: false, problems: [`迁移未生效（仍按 05_diagnosis/*.jsonl 读）：${divergence}`] };
+        }
+        const { problems: sourceProblems, refs } = await this.writeSources(seedSources());
+        const problems = [...sourceProblems, ...await this.writeCards(withSourceRefs(draft, refs, legacy, cases))];
+        return { seeded: false, migrated: problems.length === 0, problems };
+    }
+    /* ────────────────────────────────────────────── SourceRaw ── */
+    /**
+     * 落原始材料。
+     *
+     * 一个细节：种子手册与三篇复盘在**非首次**运行时可能已经存在（用户的知识根里），
+     * `addSource` 用 `externalId` 幂等，所以重复调用不会写出第二份。
+     */
+    async writeSources(sources) {
+        const problems = [];
+        const refs = new Map();
+        for (const source of sources) {
+            const added = await this.host.addSource({
+                sourceType: source.sourceType,
+                title: source.title,
+                content: source.content,
+                externalId: `diagnosis-seed:${source.id}`,
+            });
+            if (added.ok === false)
+                problems.push(`来源 ${source.id} 写入失败：${added.error.code} ${added.error.message}`);
+            else
+                refs.set(source.id, added.data.sourceId);
+        }
+        return { problems, refs };
+    }
+    /* ────────────────────────────────────────────── 一次排查的产物 ── */
+    async readRunArtifacts() {
+        const nodes = [];
+        for (const file of Object.keys(RUN_NODE_SHARDS)) {
+            for (const row of await this.readLines(join(this.dir, file))) {
+                try {
+                    nodes.push(JSON.parse(row));
+                }
+                catch { /* 跳过损坏行，不让一行毁掉整张图 */ }
+            }
+        }
+        const edges = [];
+        for (const row of await this.readLines(join(this.dir, 'edges.jsonl'))) {
+            try {
+                const edge = JSON.parse(row);
+                // 只认执行边：五种卡片边由卡片投影出来，这里再读一遍就会出现重复边。
+                if (RUN_EDGE_KINDS.includes(edge.kind))
+                    edges.push(edge);
+            }
+            catch { /* 同上 */ }
+        }
+        return { nodes, edges };
+    }
+    async writeRunArtifacts(graph) {
+        for (const [file, kind] of Object.entries(RUN_NODE_SHARDS)) {
+            const rows = graph.nodes.filter(node => node.kind === kind);
+            await this.writeIfAbsent(join(this.dir, file), rows.map(row => JSON.stringify(row)).join('\n'));
+        }
+        await this.writeIfAbsent(join(this.dir, 'edges.jsonl'), graph.edges.filter(edge => RUN_EDGE_KINDS.includes(edge.kind)).map(edge => JSON.stringify(edge)).join('\n'));
+    }
+    /** 旧版的类型层快照。首次 seed 时也写一份：它让 `05_diagnosis/` 仍是一份可读的完整快照。 */
+    async writeLegacySnapshot() {
+        for (const [file, kind] of Object.entries(LEGACY_SHARDS)) {
+            const rows = SEED_GRAPH.nodes.filter(node => node.kind === kind);
+            await this.writeIfAbsent(join(this.dir, file), rows.map(row => JSON.stringify(row)).join('\n'));
+        }
+        await this.writeIfAbsent(join(this.dir, 'cases.json'), JSON.stringify(SEED_CASES, null, 2));
+    }
+    /* ────────────────────────────────────────────── 旧读法 ── */
+    async readLegacyGraph() {
+        const nodes = [];
+        for (const [file, kind] of Object.entries({ ...LEGACY_SHARDS, ...RUN_NODE_SHARDS })) {
+            for (const row of await this.readLines(join(this.dir, file))) {
+                try {
+                    nodes.push(JSON.parse(row));
+                }
+                catch { /* 跳过损坏行 */ }
+            }
+            void kind;
+        }
+        const edges = [];
+        for (const row of await this.readLines(join(this.dir, 'edges.jsonl'))) {
+            try {
+                edges.push(JSON.parse(row));
+            }
+            catch { /* 同上 */ }
+        }
+        return { nodes, edges };
+    }
+    /**
+     * 是否存在**值得迁移的旧知识根**。
+     *
+     * 只看旧版的**类型层**分片，而且要求它真的有内容：`ensure()` 自己会为一次排查的产物
+     * （`evidence.jsonl` 等）建空占位文件 —— 若把空文件也算成「旧知识根」，首次启动会走进
+     * 迁移分支，然后在空图上白跑一趟。
+     */
+    async legacyShardFiles() {
+        const found = [];
+        for (const file of Object.keys(LEGACY_SHARDS)) {
+            if ((await this.readLines(join(this.dir, file))).length > 0)
+                found.push(file);
+        }
+        return found;
+    }
+    async readLines(path) {
+        try {
+            return (await readFile(path, 'utf8')).split('\n').map(line => line.trim()).filter(Boolean);
+        }
+        catch {
+            return [];
+        }
+    }
+    async writeIfAbsent(path, content) {
+        try {
+            await readFile(path);
+            return;
+        }
+        catch {
+            await writeFile(path, content, 'utf8');
+        }
+    }
+}
+/** 卡片正文：小节 + 结构化块。复用编解码里的同一套序列化，避免两处格式漂移。 */
+function renderBody(card) {
+    const text = serializeCard(card);
+    return text.slice(text.indexOf('\n---\n', 3) + 5).trim();
+}
+/**
+ * 给卡片挂出处。
+ *
+ * 规则是**数据驱动的**，不是凭印象分的：案例卡片与它自己的复盘原文一一对应；
+ * 其它卡片取「第一篇走过它的复盘」，没有走过它的就挂那本手册。
+ */
+function withSourceRefs(cards, refs, graph, cases) {
+    const handbook = refs.get('handbook');
+    /** 节点 id → 它出现在哪篇复盘里（取第一篇）。 */
+    const caseOf = new Map();
+    for (const item of cases) {
+        const ref = refs.get(item.id);
+        if (!ref)
+            continue;
+        caseOf.set(item.symptomId, ref);
+        for (const step of item.path)
+            if (!caseOf.has(step.nodeId))
+                caseOf.set(step.nodeId, ref);
+    }
+    void graph;
+    return cards.map(card => {
+        const own = card.entityType === 'diagnosis/case' ? refs.get(card.entityId) : undefined;
+        const ref = own ?? caseOf.get(card.entityId) ?? handbook;
+        return { ...card, sourceRefs: ref ? [ref] : [] };
+    });
+}
+/**
+ * 两张图是否一致。返回 `undefined` 表示一致，否则返回第一条差异的人话描述。
+ *
+ * 比较的是**边的身份**（kind + 两端）而不是边的 id：卡片投影出来的 id 与旧文件的 id
+ * 可能不同名（`e-s-h1` vs `e-s1-h1-0`），而 id 不是知识 —— 同一对端点上的同一种关系才是。
+ */
+function compareGraphs(expected, actual) {
+    const nodesOf = (graph) => new Set(graph.nodes.map(node => `${node.id}:${node.kind}:${node.layer}`));
+    const edgesOf = (graph) => new Set(graph.edges.map(edge => `${edge.kind}:${edge.source}->${edge.target}`));
+    const expectedNodes = nodesOf(expected);
+    const actualNodes = nodesOf(actual);
+    for (const node of expectedNodes)
+        if (!actualNodes.has(node))
+            return `节点 ${node} 在迁移后消失`;
+    for (const node of actualNodes)
+        if (!expectedNodes.has(node))
+            return `迁移后多出节点 ${node}`;
+    const expectedEdges = edgesOf(expected);
+    const actualEdges = edgesOf(actual);
+    for (const edge of expectedEdges)
+        if (!actualEdges.has(edge))
+            return `边 ${edge} 在迁移后消失`;
+    for (const edge of actualEdges)
+        if (!expectedEdges.has(edge))
+            return `迁移后多出边 ${edge}`;
+    return undefined;
+}
+/** 递归收集 markdown 文件。卡片目录是两层（`diagnosis/<kind>/`），但这里不假设层数。 */
+async function walkMarkdown(dir) {
+    const found = [];
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return found;
+    }
+    for (const entry of entries) {
+        const path = join(dir, entry.name);
+        if (entry.isDirectory())
+            found.push(...await walkMarkdown(path));
+        else if (entry.isFile() && entry.name.endsWith('.md'))
+            found.push(path);
+    }
+    return found;
+}
+export { cardPathOf };
+//# sourceMappingURL=store.js.map

package/lib/types/diagnosis/store.js.map

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

package/lib/types/diagnosis/types.d.ts

@@ -0,0 +1,124 @@
+/**
+ * 归因图谱的**领域模型**：节点 / 边 / 图 的形状与枚举。
+ *
+ * 为什么它不在 client 里：宿主也要读写同一套结构（`05_diagnosis/*.jsonl`、
+ * `/diagnosis/graph`）。视图是消费者，不是所有者 —— 模型放在领域层，客户端和宿主
+ * 各自 import，谁都不能私自改形状。
+ *
+ * 目录约定：`src/diagnosis/` 与 `src/intent/`、`src/convert/` 平级，都是领域子模块；
+ * `src/client/` 只放渲染。判据与 0020 第 3 条一致：**目录镜像领域流水线，不镜像技术层次**。
+ */
+import type { ProblemClassId } from './problem-classes.js';
+/** 类型层 / 引用层 / 实例层。轴不同，不能合成一种节点。 */
+export type NodeLayer = 'type' | 'reference' | 'instance';
+/** 九类归因节点。与 wiki 卡片的 `entity_type` 一一对应。 */
+export type AttributionNodeKind = 'symptom' | 'hypothesis' | 'check' | 'failure-mode' | 'asset' | 'case' | 'evidence' | 'cause' | 'unknown';
+/** 失败模式切面。分类只影响排序与分组，不影响「能查到什么」。 */
+export type FailureMode = 'upstream-missing' | 'spec-change' | 'data-processing' | 'consumption' | 'permission';
+/**
+ * 问题侧的分类字段（只出现在 symptom 节点上）。
+ *
+ * 与 `FailureMode` 是**两根不同的轴，不能合并**：这一对说的是「问题是什么样」，
+ * `failureMode` 说的是「原因出在哪一环」。前者挂在现象上、值班同学看到异常就能填；
+ * 后者挂在假设上、要等排查有结论。合成一根轴，就会出现「异常波动归因属于哪个问题大类」
+ * 这种没有答案的问题（0021 §4.5 与本文件顶部的分层原则）。
+ */
+export interface ProblemTaxonomy {
+    /** 问题大类。取值来自 `problem-classes.ts` 的 PROBLEM_CLASSES。 */
+    problemClass?: ProblemClassId;
+    /** 问题子类；必须属于所选大类。它同时决定 §5.1 的 shape / time_pattern。 */
+    problemSubclass?: string;
+}
+/** 九种边。层内定义可能性与顺序，跨层定义证据与复用。 */
+export type AttributionEdgeKind = 'may_be_caused_by' | 'verified_by' | 'categorized_as' | 'produces' | 'supports' | 'refutes' | 'confirmed_as' | 'instance_of' | 'indexed_from';
+export interface AttributionNode extends ProblemTaxonomy {
+    id: string;
+    kind: AttributionNodeKind;
+    layer: NodeLayer;
+    title: string;
+    /** 一句话判据。图谱视图在 tooltip 与侧栏里用它，而不是靠标题猜。 */
+    summary?: string;
+    failureMode?: FailureMode;
+    /** 被复用次数：节点大小由它决定，这是「图有没有在被用」最直接的读数。 */
+    reuseCount?: number;
+    /** 最低成本检查的耗时（分钟），单位与 0021 §4.4 一致。 */
+    costMinutes?: number;
+    automation?: 'auto' | 'manual';
+    owner?: string;
+    /**
+     * 假设的判据：一句**可判真假**的话。
+     *
+     * 与 `summary` 分开是有意的 —— `summary` 是给人读的说明，`discriminator` 是要被
+     * 校验的断言（schema 里必填），它也是新增假设前查重的比对对象。
+     */
+    discriminator?: string;
+    /**
+     * 反例边界：什么情况下这个假设**不**成立。
+     *
+     * 它是 `refutes` 边在文档层的表达，也是唯一能安放「看起来像 A 但不是 A」的地方。
+     * 没有它，查重会把所有相似情形并进一条假设，图会慢慢失去分辨力。
+     */
+    notWhen?: string;
+    /** 检查的判定阈值：看到什么算真 / 算假。缺了它，这一步就无法被自动化或复核。 */
+    verdictTrue?: string;
+    verdictFalse?: string;
+    /**
+     * 失败模式节点的稳定编码（= `FailureMode`）。只出现在 `failure-mode` 节点上。
+     *
+     * 假设卡片里写的是 `failure_mode: data-processing`（编码），而边要连到**节点**，
+     * 所以需要一条「编码 → 节点 id」的可逆映射。少了它，`categorized_as` 边就只能靠
+     * 「F1 恰好是第一个失败模式」这种位置约定去猜 —— 那是会在某次重排后静默出错的东西。
+     */
+    code?: FailureMode;
+    /** 边或节点是否已被判定失效（原因已修好 / 90 天未走）。 */
+    stale?: boolean;
+}
+export interface AttributionEdge {
+    id: string;
+    source: string;
+    target: string;
+    kind: AttributionEdgeKind;
+    /** 边上的计数：`instance_of` 上挂的是这一段的案例数。 */
+    count?: number;
+    /**
+     * 距上次走过这条边的天数。超过 `ZOMBIE_EDGE_DAYS` 就是僵尸边。
+     *
+     * 存天数而不是布尔值：`stale` 只够染个灰，而化解「权重过期」（0021 §13）需要
+     * 知道到底多久没走 —— 「94 天」和「91 天」对维护者是两种不同的紧迫感。
+     */
+    staleDays?: number;
+}
+/** 超过这么多天没走过的可能性边算僵尸边。 */
+export declare const ZOMBIE_EDGE_DAYS = 90;
+export interface AttributionGraphData {
+    nodes: AttributionNode[];
+    edges: AttributionEdge[];
+    /** 后端返回的图谱总体统计；缺省时由 summarize() 现算。 */
+    stats?: Partial<AttributionStats>;
+}
+export interface AttributionStats {
+    typeNodes: number;
+    referenceNodes: number;
+    instanceNodes: number;
+    reuseTotal: number;
+    /**
+     * 现象（问题侧）节点数。
+     *
+     * 单独数出来，是因为它和图例的关系最容易被看错：图例里的五种颜色**全是原因侧**
+     * （失败模式），而问题侧有几个节点、有没有分类，必须能一眼读到 —— 否则「图上那些
+     * 颜色在说问题还是说原因」就只能靠猜。
+     */
+    symptoms: number;
+    /**
+     * 现象覆盖到的**问题大类个数**（0–4）。
+     *
+     * 它和 `symptoms` 一起回答「问题侧的层次建起来没有」：3 个现象全挤在一个大类里，
+     * 和 3 个现象铺在 3 个大类上，是两种完全不同的知识库存量。
+     */
+    problemClasses: number;
+    /** 空区：有假设，但一条检查都没有。它是「这张图哪里还没建完」的读数。 */
+    gaps: number;
+    /** 僵尸边：90 天未被走过的 `may_be_caused_by`。 */
+    zombies: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types/diagnosis/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/diagnosis/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,oCAAoC;AACpC,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAAA;AAEzD,4CAA4C;AAC5C,MAAM,MAAM,mBAAmB,GAC3B,SAAS,GACT,YAAY,GACZ,OAAO,GACP,cAAc,GACd,OAAO,GACP,MAAM,GACN,UAAU,GACV,OAAO,GACP,SAAS,CAAA;AAEb,oCAAoC;AACpC,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG,aAAa,GAAG,iBAAiB,GAAG,aAAa,GAAG,YAAY,CAAA;AAE/G;;;;;;;GAOG;AACH,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,YAAY,CAAC,EAAE,cAAc,CAAA;IAC7B,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,gCAAgC;AAChC,MAAM,MAAM,mBAAmB,GAC3B,kBAAkB,GAClB,aAAa,GACb,gBAAgB,GAChB,UAAU,GACV,UAAU,GACV,SAAS,GACT,cAAc,GACd,aAAa,GACb,cAAc,CAAA;AAElB,MAAM,WAAW,eAAgB,SAAQ,eAAe;IACtD,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,mBAAmB,CAAA;IACzB,KAAK,EAAE,SAAS,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;IACb,0CAA0C;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,6CAA6C;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,oCAAoC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,mBAAmB,CAAA;IACzB,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,0BAA0B;AAC1B,eAAO,MAAM,gBAAgB,KAAK,CAAA;AAElC,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,eAAe,EAAE,CAAA;IACxB,KAAK,EAAE,eAAe,EAAE,CAAA;IACxB,uCAAuC;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAClC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,CAAA;IACtB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,MAAM,CAAA;IAClB;;;;;;OAMG;IACH,QAAQ,EAAE,MAAM,CAAA;IAChB;;;;;OAKG;IACH,cAAc,EAAE,MAAM,CAAA;IACtB,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAA;CAChB"}

package/lib/types/diagnosis/types.js

@@ -0,0 +1,13 @@
+/**
+ * 归因图谱的**领域模型**：节点 / 边 / 图 的形状与枚举。
+ *
+ * 为什么它不在 client 里：宿主也要读写同一套结构（`05_diagnosis/*.jsonl`、
+ * `/diagnosis/graph`）。视图是消费者，不是所有者 —— 模型放在领域层，客户端和宿主
+ * 各自 import，谁都不能私自改形状。
+ *
+ * 目录约定：`src/diagnosis/` 与 `src/intent/`、`src/convert/` 平级，都是领域子模块；
+ * `src/client/` 只放渲染。判据与 0020 第 3 条一致：**目录镜像领域流水线，不镜像技术层次**。
+ */
+/** 超过这么多天没走过的可能性边算僵尸边。 */
+export const ZOMBIE_EDGE_DAYS = 90;
+//# sourceMappingURL=types.js.map

package/lib/types/diagnosis/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/diagnosis/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA4GH,0BAA0B;AAC1B,MAAM,CAAC,MAAM,gBAAgB,GAAG,EAAE,CAAA"}