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

package/lib/types/runtime.d.ts

@@ -0,0 +1,568 @@
+import { type CardSchemaIssue, type DocumentVersion, type Envelope, type KnowledgeCard, type KnowledgeDocument, type KnowledgeDocumentDetail, type KnowledgeStatus, type RecallMode, type RecallResult, type RebuildReport, type RuntimeKnowledgeConfig, type SchemaType, type SourceRaw, type SourceRawRead, type SourceType, type SourceTypeCatalog, type SourceTypeDef, type WikiCardVersion, type WikiSchemaMode, type WikiTypeCatalog, type WikiTypeDef } from './types.js';
+import { type ModelCall } from './extract-model.js';
+import type { LineageContext, LineageRef } from 'dsh-data-contracts/refs';
+declare const LAYOUT: readonly ["01_source_truth", "02_wiki", "03_compiled", "05_diagnosis"];
+/**
+ * Both helpers delegate to the shared envelope constructors: the five-key shape
+ * and the "warnings ⇒ partial" rule live in `dsh-data-contracts`,
+ * so a knowledge response and a workbook response cannot disagree about status,
+ * and neither can forget `error: null` on the happy path.
+ */
+export declare function success<T>(data: T, warnings?: string[]): Envelope<T>;
+export declare function failure<T>(data: T, code: string, message: string, retryable?: boolean, suggestion?: string): Envelope<T>;
+export declare function parseMarkdown(source: string): {
+    frontmatter: Record<string, unknown>;
+    content: string;
+};
+/**
+ * Stage 2: turn one wiki card into recall notes.
+ *
+ * Short cards stay a single note whose content is the historical
+ * `summary + content` payload, so existing recall results and qrels keep
+ * working. Long cards that carry `##`/`###` sections split on those headings
+ * and the summary rides along with the first section.
+ */
+export declare function splitWikiNotes(card: Pick<KnowledgeCard, 'summary' | 'content'>): Array<{
+    heading?: string;
+    content: string;
+}>;
+/**
+ * 来源分类注册表的读取入口。
+ *
+ * 做成 provider 而不是构造时快照：`KnowledgeBases` 缓存的是 runtime 而不是
+ * 注册表，用户在设置里改完分类必须**立刻**对 `add_source` 生效（0013 规范
+ * 第 5 节「新增后必须立刻对 Agent 可见」）。
+ */
+export type SourceTypeProvider = () => SourceTypeDef[];
+/** Wiki 卡片类型注册表的读取入口（0024）：类型定义 + schema 生效方式。 */
+export interface WikiSchemaSnapshot {
+    types: WikiTypeDef[];
+    mode: WikiSchemaMode;
+}
+export type WikiSchemaProvider = () => WikiSchemaSnapshot;
+export interface KnowledgeRuntimeOptions {
+    /** 注册表来源；省略时用出厂内置分类。 */
+    sourceTypes?: SourceTypeProvider;
+    /** Wiki 卡片类型来源；省略时用出厂 11 个类型 + `report` 模式。 */
+    wikiSchema?: WikiSchemaProvider;
+    /**
+     * 0029：家当目录（`<agentRoot>/resource`）。
+     *
+     * 配置里那三个路径字段（`python` / `embeddingModel` / `rerankModel`）为空时，
+     * 它们从这里解析。省略时退回旧的 `TITA_DATA_AGENT_HOME` —— 独立运行时与单元
+     * 测试不必先造一个根路径。
+     */
+    resourceRoot?: string;
+    /**
+     * 0032：这个知识库的记忆段（`<agentRoot>/memory/<知识库 id>`）。
+     *
+     * 版本快照、反馈与访问审计写到这里，**不再写进知识树**。省略时退回
+     * `<rootDir>/04_memory` —— 独立运行时与单元测试不必先造一个根路径，迁移期间
+     * 「还没搬」的知识库也照常能读写。
+     */
+    memoryRoot?: string;
+    /**
+     * #3b：模型调用接缝。
+     *
+     * 运行时自己**不认识** `ctx.llm` —— 那是插件层的事。把调用以函数形式注进来，
+     * 运行时才能在 `rebuild` 里用模型做实体抽取与归并（`extract-model.ts`），
+     * 而单元测试可以塞一个假模型进去，不必真的跑一次推理。
+     *
+     * 省略 = 退回纯规则抽取（Pass 0）。那条链路本来就不依赖模型，这条接缝的存在
+     * 不能让「没有模型就跑不动」成为新的前提。
+     */
+    modelCall?: ModelCall;
+}
+export declare class KnowledgeRuntime {
+    /** 当前生效的配置。volatile 改动会就地合并进来（见 `updateConfig`），所以它不是只读的。 */
+    config: RuntimeKnowledgeConfig;
+    readonly rootDir: string;
+    /**
+     * 来源分类注册表的来源（0013）。省略时用出厂内置分类——独立 runtime 与单元
+     * 测试是这个形态；`KnowledgeBases` 会注入「按库读取」的 provider，于是每个
+     * 知识库有自己的注册表，自定义分类立刻对 Agent 可见，不需要重启。
+     */
+    private readonly sourceTypeProvider?;
+    /** Wiki 卡片类型注册表的来源（0024）；省略时用出厂 11 个类型 + `report` 模式。 */
+    private readonly wikiSchemaProvider?;
+    /**
+     * Id of the knowledge base this runtime serves. `KnowledgeBases` sets it when
+     * it creates/caches a runtime; asset URLs are built from it. Standalone
+     * runtimes keep the default so `/knowledge/assets/default/<rel>` still works.
+     */
+    baseId: string;
+    private cards;
+    private units;
+    private graph;
+    /**
+     * `docSlug → 绝对路径` 的 SourceRaw 索引（0030）。
+     *
+     * 有了它，文档 id 不需要携带来源分类也能定位文件 —— `add_source` 允许调用方自
+     * 己给 `source_id`，那串 id 里没有类型信息；而目录层级里有。索引递归覆盖整段，
+     * 所以旧平铺布局、新分类布局、以及两者并存的迁移中间态都能解析。
+     * 写入与删除后必须失效（见 `addSource` / `deleteDocument`）。
+     */
+    private sourceIndex;
+    /** 段内布局整理是否已经跑过（每个 runtime 一次）。 */
+    private segmentsOrganized;
+    private vectorIndex;
+    private vectorError;
+    private embeddingWorker;
+    /** Separate process so a rerank model failure cannot take embeddings down. */
+    private rerankWorker;
+    /** Cache the first rerank failure; do not respawn a doomed model per recall. */
+    private rerankUnavailable;
+    /** 解析后的 Python 解释器路径（配置为空时从家当目录解析）。 */
+    private pythonPath;
+    /** 解析后的嵌入模型：本地目录或 HF 模型名。 */
+    private embeddingModelPath;
+    /** 解析后的重排模型。 */
+    private rerankModelPath;
+    /**
+     * 向量清单里记的**模型身份**。
+     *
+     * 本地模型记 `resource:<相对路径>`，不记绝对路径 —— 否则把根路径搬一次，
+     * 清单里的模型名就对不上，整个向量索引被判成「配置不匹配」而作废，用户会莫名
+     * 收到一次全量重编码。清单该记「是哪一个模型」，不是「它在哪」。
+     */
+    private readonly embeddingModelId;
+    /**
+     * 这个知识库的记忆段（0032）。
+     *
+     * 它可以**在知识树之外**（正常情况就是 `<agentRoot>/memory/<库 id>`），所以
+     * 不能再走 `safePath` —— 那个守卫的契约是「不许跑出 rootDir」。这里另起一个
+     * `memoryPath`，守卫换成「不许跑出 memoryDir」。
+     */
+    private readonly memoryDir;
+    /** #3b 的模型调用接缝；undefined = 退回纯规则抽取。 */
+    private readonly modelCall;
+    constructor(rootDir: string, config?: Partial<RuntimeKnowledgeConfig>, options?: KnowledgeRuntimeOptions);
+    /**
+     * 就地应用一份新的运行时配置（0.1.7 的 volatile 改动走这条路）。
+     *
+     * 宿主改 volatile 字段时**不会重载插件**（`Entry._commitVolatile()` 只调
+     * `updateVolatile()` 就地改引用，再发一个 `loader/volatile-update`），所以「设置存下了
+     * 但没有生效」必须由这里兜住 —— 只标 volatile 不应用，就是假设置。
+     *
+     * 大部分字段是**每次调用现读** `this.config` 的（`recall` 读 `recallTopK`、
+     * `sourceTruth` 读 `allowSourceTruth`……），合并进去就生效。但有几类是**建好就缓存**
+     * 的，配置换了却还用旧的，那正是「看起来改了其实没改」：
+     *
+     * - 两个模型进程：解释器或模型路径变了，旧进程跑的还是旧模型；
+     * - 向量索引：维度或模型变了，旧向量与新查询不在同一个空间里，比出来的分没有意义。
+     *
+     * @param patch - 要合并进来的配置片段。
+     */
+    updateConfig(patch: Partial<RuntimeKnowledgeConfig>): void;
+    /** 当前生效的卡片 schema：类型定义 + 生效方式。 */
+    wikiSchema(): WikiSchemaSnapshot;
+    /**
+     * Agent 与设置面板共用的类型目录：注册表 + 生效方式 + 内置只读判定规则 +
+     * 现有卡片的三层校验结果（`report` 模式下这是"待补"清单）。
+     */
+    wikiTypeCatalog(): Promise<Envelope<WikiTypeCatalog>>;
+    /** 对已落库的卡片跑三层校验。不写盘，只报告。 */
+    lintCards(): Promise<Array<CardSchemaIssue & {
+        entityId: string;
+        entityType: string;
+    }>>;
+    /**
+     * `write_knowledge_card` 的类型闸门 + 三层校验。
+     *
+     * 返回 `{ type, issues }` 或一个失败信封。是否因 issues 拒绝写入由 `mode` 决定：
+     * `strict` 直接拒绝，`report` 把问题写进卡片并回报——存量卡片因此不会被升级挡在门外。
+     */
+    private cardSchemaGate;
+    /** 当前生效的来源分类注册表（含计算字段 `sourceCount`）。 */
+    sourceTypes(): SourceTypeDef[];
+    /** Agent 与设置面板共用的分类目录：注册表 + 内置只读判定提示词。 */
+    sourceTypeCatalog(): Envelope<SourceTypeCatalog>;
+    /**
+     * `add_source` 的分类闸门。
+     *
+     * 三态区分得很清楚，因为它们的修法完全不同：
+     * - 未知分类 → `SOURCE_TYPE_UNKNOWN`（去注册表里加，或改用一个已存在的 id）；
+     * - 已停用 → `SOURCE_TYPE_DISABLED`（去设置里重新启用，或换一个分类）；
+     * - 兜底分类被停用 → 不可能，`document` 由注册表守卫保证始终启用。
+     */
+    private sourceTypeGate;
+    directory(name: typeof LAYOUT[number]): string;
+    ensureLayout(): Promise<void>;
+    /**
+     * 0030：把平铺的 `<段>/*.md` 搬进 `<段>/<source_type>/*.md`。
+     *
+     * 三条纪律与 `migrate.ts` 一致：**只动直接躺在段目录下的 `.md`**（已经在子目录里的
+     * 不碰，所以可重入）、**读不出合法 `source_type` 的就留在原地**（宁可少搬，不可搬错
+     * ——分类只是元数据，搬错目录会让人按分类找不到东西）、**失败不回滚也不报错**（
+     * `loadSources` 两种布局都能读，搬不动不影响正确性）。
+     */
+    private migrateSourceTruthLayout;
+    /**
+     * 0030：删掉已经被撤掉的 `00_schema` 段。
+     *
+     * **只在它确实是空的时候删。** 这个段从来没被写过东西，但如果用户的目录里恰好
+     * 有人放了文件，那就不属于「没用的空文件夹」了 —— 那种情况下留着并让人自己判断，
+     * 比替他们删掉安全。
+     */
+    private dropLegacySchemaSegment;
+    private loadVectorIndex;
+    private vectorWorkerPath;
+    private encodeWithOllama;
+    private encodeEmbeddings;
+    close(): void;
+    /** Both the encoder and the reranker speak the same JSONL worker protocol. */
+    private spawnWorker;
+    private vectorInputs;
+    /** 关键词索引的最近一次失败原因；`undefined` = 上次构建成功。 */
+    private ftsError;
+    /**
+     * 关键词索引（0031）：FTS5 + BM25，见 `fts.ts`。
+     *
+     * 与向量索引的区别是它**不依赖模型**，所以 `only: 'wiki'` 也重建它 —— 卡片改了、
+     * 关键词索引不跟着改，就会出现「按旧词表召回」。`node:sqlite` 不可用时如实返回
+     * `unavailable`（诊断里会写明），而不是退回 0030 那套对中文无效的计数打分。
+     */
+    private buildFtsIndex;
+    private buildVectorIndex;
+    private loadCompiledState;
+    private safePath;
+    /**
+     * 记忆段里的一个路径（0032）。
+     *
+     * 与 `safePath` 同一套守卫，边界换成 `memoryDir` —— 记忆段现在住在知识树
+     * **外面**（`<agentRoot>/memory/<库 id>`），拿 `safePath` 拼会直接抛
+     * `PATH_OUTSIDE_KNOWLEDGE_ROOT`。两个守卫各自成立，不合并成一个「允许两个根」的
+     * 宽松版本：那样一旦哪个根算错，路径就会悄悄写到别人的目录里去。
+     */
+    private memoryPath;
+    /** 记忆段的真实位置（面板与诊断要显示它，而不是让人以为还在知识树里）。 */
+    get memoryRoot(): string;
+    stats(): Promise<Record<string, unknown>>;
+    addSource(input: {
+        sourceType: SourceType;
+        title?: string;
+        content: string;
+        externalId?: string;
+        metadata?: Record<string, unknown>;
+        sourceId?: string;
+        lineage?: LineageContext;
+    }): Promise<Envelope<{
+        sourceId: string;
+        path: string;
+        lineage?: LineageContext;
+    }>>;
+    /** Directory holding one document's version snapshots. */
+    private versionDir;
+    /** Write the previous file bytes as one immutable version snapshot. */
+    private snapshotSource;
+    /** Snapshot file basenames (without `.md`) for one document. */
+    private versionIds;
+    loadSources(): Promise<SourceRaw[]>;
+    /**
+     * Absolute path a SourceRaw document is written to.
+     *
+     * 0030：段内按来源分类分目录。`sourceType` 在调用点已经过了注册表闸门
+     * （`addSource` 的 `sourceTypeGate`），所以它一定匹配 `SOURCE_TYPE_ID_PATTERN`，
+     * 不会引入路径穿越。
+     */
+    private sourcePath;
+    /** 递归扫 SourceRaw 段，建 `docSlug → path` 索引；两种布局都覆盖。 */
+    private sourceIndexMap;
+    /** 已知文档 id 的落盘位置；不存在时 `undefined`（调用方各自决定怎么报错）。 */
+    private sourcePathOf;
+    /**
+     * Assets a document really has on disk.
+     *
+     * Preferred source of truth is `metadata.assets` (knowledge-root-relative
+     * paths written by `convert/ingest.ts`). Documents written by hand fall back
+     * to parsing local markdown image links. A link is resolved **knowledge-root
+     * first, then relative to the document's own directory**: the convert ingest
+     * seam re-bases assets to `_assets/<bucket>/<name>` (root-relative), while
+     * hand-written docs typically use a sibling path. Only existing files are
+     * returned, so `assetCount` is never an over-count.
+     */
+    private assetsOf;
+    /** Parse one on-disk SourceRaw file into the detail projection. */
+    private readDocumentFile;
+    /** 文档列表（新→旧），正文/资产明细留在详情接口里。 */
+    listDocuments(): Promise<KnowledgeDocument[]>;
+    /** 文档详情：正文、frontmatter、资产与 lineage。 */
+    readDocument(docId: string): Promise<KnowledgeDocumentDetail | undefined>;
+    /**
+     * 版本历史，新→旧。
+     *
+     * 第一条永远是当前 head（`isCurrent: true`，`versionId` 形如
+     * `current-<hash8>`），其后是 `04_memory/source-versions/<docSlug>/` 里的
+     * 历史快照。快照保存的是**被覆盖前的原文件字节**，因此回滚是字节级的。
+     */
+    listVersions(docId: string): Promise<DocumentVersion[]>;
+    /**
+     * 回滚到某个历史版本。
+     *
+     * 语义：用快照内容重新调用 `addSource`。因为 `addSource` 在覆盖前会把当前
+     * head 再快照一次，所以**回滚本身也可回滚**，历史只增不减。
+     * `current-<hash8>` 指向当前 head，属于 no-op，直接返回当前详情。
+     */
+    revertDocument(docId: string, versionId: string): Promise<Envelope<KnowledgeDocumentDetail>>;
+    /** 删除文档本体与其版本历史（重新写入同一 sourceId 会从头开始记版本）。 */
+    deleteDocument(docId: string): Promise<Envelope<{
+        deleted: true;
+    }>>;
+    writeCard(input: {
+        entityType: SchemaType;
+        entityId: string;
+        title: string;
+        content: string;
+        sourceRefs: string[];
+        status?: KnowledgeStatus;
+        summary?: string; /**
+         * 负责人。它属于 0021 §6.4 的卡片信封（智能归因的五类卡片里 `check.owner` 是必填 ——
+         * 「这一步该找谁」和成本、判定阈值一样是执行信息）；其余 entity_type 不使用它。
+         */
+        owner?: string;
+        metadata?: Record<string, unknown>;
+        lineage?: LineageContext;
+        provenance?: LineageRef[];
+    }): Promise<Envelope<{
+        entityId: string;
+        path: string;
+        lineage?: LineageContext;
+    }>>;
+    /** Directory holding one wiki card's version snapshots. */
+    private cardVersionDir;
+    /** Write the previous card file bytes as one immutable version snapshot. */
+    private snapshotCard;
+    /** Snapshot basenames (without `.md`) for one card, newest first. */
+    private cardVersionIds;
+    /** Resolve one card by id, optionally constrained to a type (ids are unique per type). */
+    readCard(entityId: string, entityType?: SchemaType): Promise<KnowledgeCard | undefined>;
+    /**
+     * Version list for one card: the newest snapshot reported as current *plus* the
+     * live head. The head is not itself a snapshot — it is the file on disk — but a
+     * version list that omits what you are looking at is unreadable.
+     */
+    listCardVersions(entityId: string, entityType?: SchemaType): Promise<WikiCardVersion[]>;
+    /** 回滚一张卡片到历史快照；写入走 writeCard，所以**回滚前的当前版本也会被快照**。 */
+    revertCard(entityId: string, versionId: string, entityType?: SchemaType): Promise<Envelope<KnowledgeCard>>;
+    loadCards(): Promise<KnowledgeCard[]>;
+    setStatus(entityId: string, status: KnowledgeStatus, problemNote?: string, lineage?: LineageContext): Promise<Envelope<{
+        entityId: string;
+        status: KnowledgeStatus;
+        lineage?: LineageContext;
+    }>>;
+    /**
+     * Stage 2: compile wiki cards into wikiNotes.
+     *
+     * A note is the unit stage 3 recalls and stage 4 reranks. Every note keeps a
+     * `wikiId` pointer so recall can always resolve the authoritative wiki card,
+     * and the first note of a wiki keeps the historical `<type>:<id>` unitId.
+     *
+     * Split per card (not per corpus) so the incremental rebuild can recompile one
+     * card's notes while keeping every other card's `unitId`s — and therefore their
+     * vectors — exactly as they were.
+     */
+    private compileNotes;
+    private compileCardNotes;
+    /** 1-hop neighbourhood of a set of wiki cards inside the compiled graph. */
+    private oneHopGraph;
+    /**
+     * Stage 4: BERT cross-encoder rerank over the recalled wikiNotes.
+     *
+     * Mirrors the embedding path: a missing model or worker degrades to the
+     * fused score order with an explicit warning instead of faking a score.
+     *
+     * 0031 的两处改动：
+     * 1. **作用在候选池上**，不再是已经截断到 `recallTopK` 的那 10 条 —— 否则重排只能
+     *    换顺序，救不回被融合排到窗口外的那一条（0014 点名的「分层只做了一半」）。
+     * 2. **带阈值**：低于 `threshold` 的一律丢弃，并报出丢了几条。「弃答」主要靠它 ——
+     *    cross-encoder 的分是**跨查询可比**的，而关键词/向量的阈值做不到这一点。
+     *
+     * `threshold` 与 WeKnora 同刻度（**原始 logit**，默认 0.2）；worker 用
+     * `predict_raw` 保证这一点（`predict` 默认会套 sigmoid），`rerankScore` 是
+     * sigmoid 之后的展示值，两者单调等价，排序不受影响。刻度换算集中在
+     * `applyRerank`（纯函数，有测试），这里不再自己乘除。
+     */
+    private rerankNotes;
+    /**
+     * Fingerprint of everything a wikiNote is compiled *from*.
+     *
+     * Deliberately excludes the fields that are cheap to refresh on a reused note
+     * (`provenance`, `imagePaths`, `metadata`) and includes the ones that change
+     * what the note says (`title`, `status`, `content`, `sourceRefs`). A card whose
+     * fingerprint is unchanged produces byte-identical notes, so reusing them is
+     * not a shortcut — it is the same answer without the churn.
+     */
+    private cardHashOf;
+    /** Previous `wiki_notes.json` (or the pre-0014 mirror), without touching `this.units`. */
+    private readNotesArtifact;
+    /**
+     * 来源的抽取指纹。
+     *
+     * 三项缺一不可：
+     * - **正文**：文档本身变了，抽出来的东西自然要重算；
+     * - **声明式候选**：它们只写在 `metadata` 里（`SourceRaw` 只投影这一块），
+     *   正文不变而声明变了是常见操作，不带上它就会漏抽；
+     * - **启用的类型注册表**：用户新登记一个 wiki 类型后，同一份文档的判型结论会变。
+     *   不把注册表算进指纹，「来源没变就永远不重抽」会把新类型永远锁在门外。
+     */
+    private extractionFingerprint;
+    /** 一次 Pass 0 的真实结果：计数器 + 待装配的关系 + 来源指纹。 */
+    private emptyExtractionOutcome;
+    /**
+     * Pass 0：对指纹变了的来源做候选抽取 + 归一，并把结果落成 wiki 卡片。
+     *
+     * 三条硬约束：
+     * 1. **增量**：指纹没变的来源一次都不抽（这是 0025 增量承诺的一部分）；
+     * 2. **不重写没变的卡片**：合并只追加 `source_refs`，正文不动，所以不会凭空造
+     *    版本快照（`snapshotCard` 只认正文变化）；
+     * 3. **fail-soft**：一个候选被闸门拒绝、甚至一份来源整个抛错，都只记一笔，
+     *    绝不带走整次重建 —— 重建失败比少一张卡片严重得多。
+     */
+    private runExtractionStage;
+    /** 读回关系产物。文件不在或读不动都当「没有」，不抛。 */
+    private readExtractedRelations;
+    /** 落盘关系产物。失败只记一笔：它不该带走整次重建。 */
+    private writeExtractedRelations;
+    /** 一份来源的抽取结果：新建候选卡片、把证据来源并进已有卡片、收集关系候选。 */
+    private extractFromSource;
+    /**
+     * 把关系候选装配成 wiki↔wiki 的边。
+     *
+     * 只有两端都解析到**已存在的 wiki 节点**时才加边，其余丢弃并计数：凭空造一个
+     * 节点会给图上留一个点不开的孤立点，比没有这条边更难解释。自环同理丢弃。
+     * `supported_by`（卡片 → 来源）完全不受影响，它是另一套边。
+     */
+    private applyExtractedRelations;
+    rebuild(only?: 'all' | 'schema' | 'wiki' | 'embeddings', lineage?: LineageContext, options?: {
+        extract?: boolean;
+    }): Promise<Envelope<RebuildReport>>;
+    /**
+     * The staged read path:
+     *   3) recall — multi-route (keyword + vector + knowledge graph) recall over
+     *      wikiNotes, bounded by `recallTopK`, then resolve each hit's wiki and
+     *      its 1-hop graph;
+     *   4) rerank — BERT cross-encoder, then expand only `contextTopN` notes
+     *      into the context pack handed to the model.
+     */
+    /**
+     * 编码器健康门（0031 的 P0）。
+     *
+     * 0030 的真实故障：WeMM 经 `SentenceTransformer.encode` 对**任何输入返回同一个向量**
+     * （实测四段无关文本两两 `cos = 1.000000`），而整条链路照样上报
+     * `routes: ["fts","vector","graph"]` —— 谎报「三路都在跑」。索引里 44 行有 39 行逐字节
+     * 相同，排序退化成 `unitId` 字典序，而界面上看不出任何异常。
+     *
+     * 所以「能不能用」不能靠「跑没跑」来判断，要**实测**：编码两段无关文本，要求余弦远小于 1。
+     * 不通过就关掉向量路并如实说明 —— 一条会撒谎的路比没有这条路更坏。
+     *
+     * 代价：第一次用到向量路时要起一次 worker（模型常驻之后就是一次往返）。这个代价是
+     * 必要的，而且它和「第一次召回本来就要加载模型」重叠。
+     */
+    private encoderHealth;
+    private checkEncoder;
+    /** 关键词路：FTS5 + BM25（0031）。索引不在时如实降级，不退回旧的计数打分。 */
+    private ftsRoute;
+    /**
+     * 向量路：健康门 → 编码一次 → 原始余弦 → 阈值。
+     *
+     * 分数**不再**做 `(cosine + 1) / 2` 的映射：那个映射把余弦压进 0..1 之后，`0.15` 这样的
+     * 阈值就完全失去意义（余弦 0 会被映射成 0.5，轻松过线）。原始余弦是绝对量，可以直接
+     * 用来判「这段内容和问题到底像不像」—— 弃答主要靠它和重排阈值。
+     */
+    private vectorRoute;
+    /**
+     * 图谱的**名次表**（不是一路分数，见 `graphBoost`）。
+     *
+     * 匹配逻辑与 0030 相同（词面匹配节点 title / id 与关系词，命中节点带出 1 跳邻居并衰减），
+     * 但返回值只用于给**已经在候选池里**的条目加权 —— 它自己不能制造候选。
+     */
+    private graphBoostRanking;
+    /** SourceRaw 正文，按 sourceId 索引；证据片段从这里取。写入后失效。 */
+    private sourceCorpusCache;
+    private sourceCorpus;
+    /**
+     * 给命中挂上**证据片段**（0031）。
+     *
+     * `sourceRefs` 只说了「这条结论出自哪几份 SourceRaw」，而模型要核对一个数字时需要的
+     * 是**那一段原文**。这里把它解析出来放进上下文，于是「每个数字都能指回它的口径定义与
+     * 原始文档」在上下文层面成立，而不是靠模型自觉再调一次工具。
+     */
+    private attachEvidence;
+    recall(query: string, limit?: number, sourceTypes?: string[], includeProblems?: boolean, mode?: RecallMode, lineage?: LineageContext, options?: {
+        contextTopN?: number;
+        rerank?: boolean;
+    }): Promise<Envelope<RecallResult>>;
+    /**
+     * 向量路的原始余弦（0031 修了两个数）。
+     *
+     * 1. **分母**：向量在入库与查询时都已归一（实测 `|v| = 0.9992`），量化是 `round(v × 127)`，
+     *    所以 `Σ q_i·s_i ≈ 127²·cos`，正确分母是 `127²`。0030 写的是 `127² × dimension`，
+     *    多除了一个 1024 —— 任何余弦都被压进 ±0.001，再经 `(cos+1)/2` 之后所有候选都落在
+     *    0.5 附近，**排序完全没有区分度**（实测：某行自相似度算出来是 0.000975，应为 1.0）。
+     * 2. **量纲**：返回**原始余弦**，不再做 `(cos+1)/2` 的映射 —— 那个映射让 `0.15` 这类阈值
+     *    失去意义（余弦 0 → 0.5，轻松过线）。原始余弦是绝对量，可以直接用于弃答。
+     */
+    private vectorRecall;
+    /**
+     * 解析后的三个「家当」路径（0029）。
+     *
+     * 设置面板用它显示「自动」到底指向哪里：配置里那三个字段空着就是「跟着根路径
+     * 走」，但用户要看到的是**真实路径**，否则「自动」等于没说。
+     */
+    resourcePaths(): {
+        python: string;
+        embeddingModel: string;
+        rerankModel: string;
+        embeddingModelId: string;
+    };
+    embeddingHealth(): Promise<Envelope<Record<string, unknown>>>;
+    /**
+     * Stage 5（旁路）：读 SourceRaw 原文，**带配额**。
+     *
+     * 配额是「top `max_chars` 字符」（默认与上限都是 40000），而且是**跨多条来源共享**的，
+     * 所以一份长文档很可能只回来开头。这件事必须**说出来**，不能靠调用方自己猜：
+     *
+     * - 每条带上 `path`（磁盘绝对路径）与 `totalChars`；
+     * - 信封上带 `truncated`。
+     *
+     * 看到 `truncated: true` 或 `returnedChars < totalChars`，就该去读那个文件 —— 这条
+     * 路径是知识库里的真实文件，读它与读这里的内容是同一份数据，而且没有配额。这样
+     * 「一次读不完」就不再等于「读不到」，也不会出现「以为拿到全文、其实只有前 4 万字符」。
+     */
+    sourceTruth(query: string, sourceTypes?: string[], limit?: number, maxChars?: number, lineage?: LineageContext): Promise<Envelope<{
+        sources: SourceRawRead[];
+        sourceReadId: string;
+        maxChars: number;
+        returnedChars: number;
+        truncated: boolean;
+        lineage?: LineageContext;
+    }>>;
+    graphQuery(action: 'entity' | 'neighbors' | 'path' | 'list' | 'types', entityId?: string, entityType?: string, depth?: number, options?: {
+        fromId?: string;
+        toId?: string;
+        status?: string;
+        includeProblem?: boolean;
+        limit?: number;
+    }, lineage?: LineageContext): Promise<Envelope<Record<string, unknown>>>;
+    recordFeedback(input: {
+        feedbackId?: string;
+        unitId?: string;
+        rating: number;
+        comment?: string;
+        sessionKey?: string;
+        lineage?: LineageContext;
+    }): Promise<Envelope<{
+        feedbackId: string;
+        lineage?: LineageContext;
+    }>>;
+    audit(action: string, metadata: Record<string, unknown>): Promise<void>;
+}
+/**
+ * @deprecated 0029：知识树的根不再是「一个路径」，而是
+ * `<agentRoot>/domain_knowledge/<知识库 id>`。这里保留旧名字只为让外部调用点
+ * （注册表的默认库、测试）有个可迁移的入口；新代码一律用 `layout.ts` 的
+ * `knowledgeBaseRoot()`。它返回的是**旧布局**的位置，也就是迁移的来源。
+ */
+export declare function defaultKnowledgeRoot(): string;
+export {};
+//# sourceMappingURL=runtime.d.ts.map

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

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