dsh-data-domain-knowledge 0.1.0-alpha.9 → 0.1.1-alpha.2

package/lib/types/settings-schema.d.ts

@@ -24,7 +24,7 @@
  * **注册命名空间**那一步就抛异常（`register` 先 `resolve` 再登记）：
  *
  * - 命名空间从未注册 → 面板上整个知识库设置显示「设置服务不可用」；
- * - `swap()` 永远不被调用 → `migrateLegacyResources` 从不执行（家当一直留在旧位置）；
+ * - `swap()` 永远不被调用 → 资源路径不会被运行时自动改写；
  * - `settings.yaml` 里存的值一个都不生效。
  *
  * 而且是**全量**失效，不是只有这三个字段 —— 所以这三个字段只约束「是字符串」，
@@ -37,13 +37,8 @@ import z from '@deepseek-ai/schemastery';
 export declare const SETTINGS_NAMESPACE = "tita-data-agent-knowledge";
 export declare const KNOWLEDGE_SETTINGS_SCHEMA: z<Schemastery.ObjectS<NoInfer<{
     /**
-     * **用户唯一要设的路径**（0029）。四段布局由它推出来，见 `layout.ts`。
-     */
-    agentRoot: z<string, string, "defined">;
-    /**
-     * @deprecated 0029：旧布局的知识树根。**只作为一次性迁移的来源**保留 ——
-     * 它不再出现在设置面板里，也不再决定任何路径。留一个宽松的字符串默认值，
-     * 是为了让老用户的 settings JSON 还能被解析出来，从而知道旧树在哪。
+     * @deprecated 0029：旧布局的知识树根。仅保留字段形状以兼容旧配置；
+     * 新逻辑忽略它，也不会读取或迁移旧树。
      */
     rootDir: z<string, string, "defined">;
     schemaTypes: z<("case" | "table" | "metric" | "diagnosis/symptom" | "diagnosis/hypothesis" | "diagnosis/check-point" | "diagnosis/failure-reason" | "diagnosis/case" | "concept" | "event" | "playbook")[], ("case" | "table" | "metric" | "diagnosis/symptom" | "diagnosis/hypothesis" | "diagnosis/check-point" | "diagnosis/failure-reason" | "diagnosis/case" | "concept" | "event" | "playbook")[], "defined">;
@@ -62,7 +57,6 @@ export declare const KNOWLEDGE_SETTINGS_SCHEMA: z<Schemastery.ObjectS<NoInfer<{
     embeddingDevice: z<"auto" | "mps" | "cpu", "auto" | "mps" | "cpu", "defined">;
     recallTopK: z<number, number, "defined">;
     recallCandidatePool: z<number, number, "defined">;
-    recallMode: z<"fts" | "vector" | "hybrid", "fts" | "vector" | "hybrid", "defined">;
     keywordThreshold: z<number, number, "defined">;
     vectorThreshold: z<number, number, "defined">;
     contextTopN: z<number, number, "defined">;
@@ -71,15 +65,17 @@ export declare const KNOWLEDGE_SETTINGS_SCHEMA: z<Schemastery.ObjectS<NoInfer<{
     rerankProvider: z<"none" | "bert-python", "none" | "bert-python", "defined">;
     rerankModel: z<string, string, "defined">;
     rerankTimeoutMs: z<number, number, "defined">;
-}>>, Schemastery.ObjectT<NoInfer<{
     /**
-     * **用户唯一要设的路径**（0029）。四段布局由它推出来，见 `layout.ts`。
+     * **固定的 Agent 根路径**。它不标记为 volatile，因此不会出现在设置弹层里；旧配置
+     * 仍保留在 schema 中，供旧配置平滑解析；运行时只使用新的默认根路径。
      */
     agentRoot: z<string, string, "defined">;
+    /** 固定多路径融合。保留旧路线值以平滑读取旧配置，但不标成可编辑设置。 */
+    recallMode: z<"fts" | "vector" | "hybrid", "fts" | "vector" | "hybrid", "defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
     /**
-     * @deprecated 0029：旧布局的知识树根。**只作为一次性迁移的来源**保留 ——
-     * 它不再出现在设置面板里，也不再决定任何路径。留一个宽松的字符串默认值，
-     * 是为了让老用户的 settings JSON 还能被解析出来，从而知道旧树在哪。
+     * @deprecated 0029：旧布局的知识树根。仅保留字段形状以兼容旧配置；
+     * 新逻辑忽略它，也不会读取或迁移旧树。
      */
     rootDir: z<string, string, "defined">;
     schemaTypes: z<("case" | "table" | "metric" | "diagnosis/symptom" | "diagnosis/hypothesis" | "diagnosis/check-point" | "diagnosis/failure-reason" | "diagnosis/case" | "concept" | "event" | "playbook")[], ("case" | "table" | "metric" | "diagnosis/symptom" | "diagnosis/hypothesis" | "diagnosis/check-point" | "diagnosis/failure-reason" | "diagnosis/case" | "concept" | "event" | "playbook")[], "defined">;
@@ -98,7 +94,6 @@ export declare const KNOWLEDGE_SETTINGS_SCHEMA: z<Schemastery.ObjectS<NoInfer<{
     embeddingDevice: z<"auto" | "mps" | "cpu", "auto" | "mps" | "cpu", "defined">;
     recallTopK: z<number, number, "defined">;
     recallCandidatePool: z<number, number, "defined">;
-    recallMode: z<"fts" | "vector" | "hybrid", "fts" | "vector" | "hybrid", "defined">;
     keywordThreshold: z<number, number, "defined">;
     vectorThreshold: z<number, number, "defined">;
     contextTopN: z<number, number, "defined">;
@@ -107,5 +102,12 @@ export declare const KNOWLEDGE_SETTINGS_SCHEMA: z<Schemastery.ObjectS<NoInfer<{
     rerankProvider: z<"none" | "bert-python", "none" | "bert-python", "defined">;
     rerankModel: z<string, string, "defined">;
     rerankTimeoutMs: z<number, number, "defined">;
+    /**
+     * **固定的 Agent 根路径**。它不标记为 volatile，因此不会出现在设置弹层里；旧配置
+     * 仍保留在 schema 中，供旧配置平滑解析；运行时只使用新的默认根路径。
+     */
+    agentRoot: z<string, string, "defined">;
+    /** 固定多路径融合。保留旧路线值以平滑读取旧配置，但不标成可编辑设置。 */
+    recallMode: z<"fts" | "vector" | "hybrid", "fts" | "vector" | "hybrid", "defined">;
 }>>, "plain">;
 //# sourceMappingURL=settings-schema.d.ts.map

package/lib/types/settings-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"settings-schema.d.ts","sourceRoot":"","sources":["../../src/settings-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAMxC,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,8BAA8B,CAAA;AAE7D,eAAO,MAAM,yBAAyB;IACpC;;OAEG;;IAEH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;IARH;;OAEG;;IAEH;;;;OAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;aAwCF,CAAA"}
+{"version":3,"file":"settings-schema.d.ts","sourceRoot":"","sources":["../../src/settings-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AAMxC,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,8BAA8B,CAAA;AAE7D,eAAO,MAAM,yBAAyB;IASpC;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;IAXH;;;OAGG;;IAEH,wCAAwC;;;IAGxC;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;IAXH;;;OAGG;;IAEH,wCAAwC;;aA8CxC,CAAA"}

package/lib/types/settings-schema.js

@@ -24,7 +24,7 @@
  * **注册命名空间**那一步就抛异常（`register` 先 `resolve` 再登记）：
  *
  * - 命名空间从未注册 → 面板上整个知识库设置显示「设置服务不可用」；
- * - `swap()` 永远不被调用 → `migrateLegacyResources` 从不执行（家当一直留在旧位置）；
+ * - `swap()` 永远不被调用 → 资源路径不会被运行时自动改写；
  * - `settings.yaml` 里存的值一个都不生效。
  *
  * 而且是**全量**失效，不是只有这三个字段 —— 所以这三个字段只约束「是字符串」，
@@ -39,54 +39,57 @@ import { defaultAgentRoot } from './layout.js';
 import { DIAGNOSIS_ENTITY_TYPES } from './diagnosis/schema.js';
 /** 设置命名空间。命名规则是 `^[a-z][a-z0-9-]*$`（dsh-settings 的 `parseSettingsNamespace`）。 */
 export const SETTINGS_NAMESPACE = 'tita-data-agent-knowledge';
-export const KNOWLEDGE_SETTINGS_SCHEMA = z.object(volatileFields({
+export const KNOWLEDGE_SETTINGS_SCHEMA = z.object({
     /**
-     * **用户唯一要设的路径**（0029）。四段布局由它推出来，见 `layout.ts`。
+     * **固定的 Agent 根路径**。它不标记为 volatile，因此不会出现在设置弹层里；旧配置
+     * 仍保留在 schema 中，供旧配置平滑解析；运行时只使用新的默认根路径。
      */
     agentRoot: z.string().min(1).default(defaultAgentRoot()),
-    /**
-     * @deprecated 0029：旧布局的知识树根。**只作为一次性迁移的来源**保留 ——
-     * 它不再出现在设置面板里，也不再决定任何路径。留一个宽松的字符串默认值，
-     * 是为了让老用户的 settings JSON 还能被解析出来，从而知道旧树在哪。
-     */
-    rootDir: z.string().default(''),
-    schemaTypes: z.array(z.union(['concept', 'metric', 'table', 'event', 'playbook', 'case', ...DIAGNOSIS_ENTITY_TYPES])).default(DEFAULT_KNOWLEDGE_CONFIG.schemaTypes),
-    allowSourceTruth: z.boolean().default(DEFAULT_KNOWLEDGE_CONFIG.allowSourceTruth),
-    extractCandidates: z.boolean().default(DEFAULT_KNOWLEDGE_CONFIG.extractCandidates),
-    // #3b：模型抽取与归并。默认关 —— 它会真花钱、也依赖模型可用，所以由用户显式打开。
-    extractWithModel: z.boolean().default(DEFAULT_KNOWLEDGE_CONFIG.extractWithModel),
-    // 空串 = 自动（本库启用的第一个类型）。**不能加 .min(1)** —— 默认值就是空串。
-    layoutProfileId: z.string().default(DEFAULT_KNOWLEDGE_CONFIG.layoutProfileId),
-    // 卡片组织（模型）。默认开 —— Wiki 正文要先经过物化编译；显式 false 才关闭。
-    cardOrganize: z.boolean().default(DEFAULT_KNOWLEDGE_CONFIG.cardOrganize),
-    // 下面三个是「空串 = 自动」的字段，**不能加 .min(1)**：默认值就是空串，而
-    // schemastery 会校验默认值 —— 加了会让整个命名空间注册失败（见文件头注释）。
-    python: z.string().default(DEFAULT_KNOWLEDGE_CONFIG.python),
-    embeddingProvider: z.union(['wemm-python', 'ollama', 'none']).default(DEFAULT_KNOWLEDGE_CONFIG.embeddingProvider),
-    embeddingBaseUrl: z.string().min(1).default(DEFAULT_KNOWLEDGE_CONFIG.embeddingBaseUrl),
-    embeddingModel: z.string().default(DEFAULT_KNOWLEDGE_CONFIG.embeddingModel),
-    embeddingDimension: z.number().step(1).min(1).default(DEFAULT_KNOWLEDGE_CONFIG.embeddingDimension),
-    embeddingBatchSize: z.number().step(1).min(1).max(64).default(DEFAULT_KNOWLEDGE_CONFIG.embeddingBatchSize),
-    embeddingTimeoutMs: z.number().step(1).min(1000).max(600000).default(DEFAULT_KNOWLEDGE_CONFIG.embeddingTimeoutMs),
-    embeddingDevice: z.union(['auto', 'mps', 'cpu']).default(DEFAULT_KNOWLEDGE_CONFIG.embeddingDevice),
-    recallTopK: z.number().step(1).min(1).max(50).default(DEFAULT_KNOWLEDGE_CONFIG.recallTopK),
-    // 0031：候选池与最终条数彻底分开。上限 200 是因为再深也只是把噪声往后排，
-    // 而重排的代价随候选数线性增长。
-    recallCandidatePool: z.number().step(1).min(1).max(200).default(DEFAULT_KNOWLEDGE_CONFIG.recallCandidatePool),
+    /** 固定多路径融合。保留旧路线值以平滑读取旧配置，但不标成可编辑设置。 */
     recallMode: z.union(['fts', 'vector', 'hybrid']).default(DEFAULT_KNOWLEDGE_CONFIG.recallMode),
-    // 阈值区间都开满：初值取 WeKnora 的出厂值，但校准要能自由调。
-    // 关键词是归一化 BM25（0..1，相对），向量是原始余弦（−1..1，绝对）。
-    keywordThreshold: z.number().min(0).max(1).default(DEFAULT_KNOWLEDGE_CONFIG.keywordThreshold),
-    vectorThreshold: z.number().min(-1).max(1).default(DEFAULT_KNOWLEDGE_CONFIG.vectorThreshold),
-    contextTopN: z.number().step(1).min(1).max(50).default(DEFAULT_KNOWLEDGE_CONFIG.contextTopN),
-    // 0050：上下文最大字符数。`0` = 不限（不是「默认」，是明确要求不设上限）。
-    contextMaxChars: z.number().step(1000).min(0).max(1_000_000).default(DEFAULT_KNOWLEDGE_CONFIG.contextMaxChars),
-    // 重排阈值与 WeKnora 同刻度：**原始 cross-encoder logit**（−10..10，默认 0.2）。
-    // 展示用的 `rerankScore` 是它的 sigmoid，两者单调等价 —— 但阈值留在原始刻度上，
-    // 这样「0.2」这个数与参照实现的配置可以直接对照。
-    rerankThreshold: z.number().min(-10).max(10).default(DEFAULT_KNOWLEDGE_CONFIG.rerankThreshold),
-    rerankProvider: z.union(['bert-python', 'none']).default(DEFAULT_KNOWLEDGE_CONFIG.rerankProvider),
-    rerankModel: z.string().default(DEFAULT_KNOWLEDGE_CONFIG.rerankModel),
-    rerankTimeoutMs: z.number().step(1).min(1000).max(600000).default(DEFAULT_KNOWLEDGE_CONFIG.rerankTimeoutMs),
-}));
+    ...volatileFields({
+        /**
+         * @deprecated 0029：旧布局的知识树根。仅保留字段形状以兼容旧配置；
+         * 新逻辑忽略它，也不会读取或迁移旧树。
+         */
+        rootDir: z.string().default(''),
+        schemaTypes: z.array(z.union(['concept', 'metric', 'table', 'event', 'playbook', 'case', ...DIAGNOSIS_ENTITY_TYPES])).default(DEFAULT_KNOWLEDGE_CONFIG.schemaTypes),
+        allowSourceTruth: z.boolean().default(DEFAULT_KNOWLEDGE_CONFIG.allowSourceTruth),
+        extractCandidates: z.boolean().default(DEFAULT_KNOWLEDGE_CONFIG.extractCandidates),
+        // #3b：模型抽取与归并。默认关 —— 它会真花钱、也依赖模型可用，所以由用户显式打开。
+        extractWithModel: z.boolean().default(DEFAULT_KNOWLEDGE_CONFIG.extractWithModel),
+        // 空串 = 自动（本库启用的第一个类型）。**不能加 .min(1)** —— 默认值就是空串。
+        layoutProfileId: z.string().default(DEFAULT_KNOWLEDGE_CONFIG.layoutProfileId),
+        // 卡片组织（模型）。默认开 —— Wiki 正文要先经过物化编译；显式 false 才关闭。
+        cardOrganize: z.boolean().default(DEFAULT_KNOWLEDGE_CONFIG.cardOrganize),
+        // 下面三个是「空串 = 自动」的字段，**不能加 .min(1)**：默认值就是空串，而
+        // schemastery 会校验默认值 —— 加了会让整个命名空间注册失败（见文件头注释）。
+        python: z.string().default(DEFAULT_KNOWLEDGE_CONFIG.python),
+        embeddingProvider: z.union(['wemm-python', 'ollama', 'none']).default(DEFAULT_KNOWLEDGE_CONFIG.embeddingProvider),
+        embeddingBaseUrl: z.string().min(1).default(DEFAULT_KNOWLEDGE_CONFIG.embeddingBaseUrl),
+        embeddingModel: z.string().default(DEFAULT_KNOWLEDGE_CONFIG.embeddingModel),
+        embeddingDimension: z.number().step(1).min(1).default(DEFAULT_KNOWLEDGE_CONFIG.embeddingDimension),
+        embeddingBatchSize: z.number().step(1).min(1).max(64).default(DEFAULT_KNOWLEDGE_CONFIG.embeddingBatchSize),
+        embeddingTimeoutMs: z.number().step(1).min(1000).max(600000).default(DEFAULT_KNOWLEDGE_CONFIG.embeddingTimeoutMs),
+        embeddingDevice: z.union(['auto', 'mps', 'cpu']).default(DEFAULT_KNOWLEDGE_CONFIG.embeddingDevice),
+        recallTopK: z.number().step(1).min(1).max(50).default(DEFAULT_KNOWLEDGE_CONFIG.recallTopK),
+        // 0031：候选池与最终条数彻底分开。上限 200 是因为再深也只是把噪声往后排，
+        // 而重排的代价随候选数线性增长。
+        recallCandidatePool: z.number().step(1).min(1).max(200).default(DEFAULT_KNOWLEDGE_CONFIG.recallCandidatePool),
+        // 阈值区间都开满：初值取 WeKnora 的出厂值，但校准要能自由调。
+        // 关键词是归一化 BM25（0..1，相对），向量是原始余弦（−1..1，绝对）。
+        keywordThreshold: z.number().min(0).max(1).default(DEFAULT_KNOWLEDGE_CONFIG.keywordThreshold),
+        vectorThreshold: z.number().min(-1).max(1).default(DEFAULT_KNOWLEDGE_CONFIG.vectorThreshold),
+        contextTopN: z.number().step(1).min(1).max(50).default(DEFAULT_KNOWLEDGE_CONFIG.contextTopN),
+        // 0050：上下文最大字符数。`0` = 不限（不是「默认」，是明确要求不设上限）。
+        contextMaxChars: z.number().step(1000).min(0).max(1_000_000).default(DEFAULT_KNOWLEDGE_CONFIG.contextMaxChars),
+        // 重排阈值与 WeKnora 同刻度：**原始 cross-encoder logit**（−10..10，默认 0.2）。
+        // 展示用的 `rerankScore` 是它的 sigmoid，两者单调等价 —— 但阈值留在原始刻度上，
+        // 这样「0.2」这个数与参照实现的配置可以直接对照。
+        rerankThreshold: z.number().min(-10).max(10).default(DEFAULT_KNOWLEDGE_CONFIG.rerankThreshold),
+        rerankProvider: z.union(['bert-python', 'none']).default(DEFAULT_KNOWLEDGE_CONFIG.rerankProvider),
+        rerankModel: z.string().default(DEFAULT_KNOWLEDGE_CONFIG.rerankModel),
+        rerankTimeoutMs: z.number().step(1).min(1000).max(600000).default(DEFAULT_KNOWLEDGE_CONFIG.rerankTimeoutMs),
+    }),
+});
 //# sourceMappingURL=settings-schema.js.map

package/lib/types/settings-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"settings-schema.js","sourceRoot":"","sources":["../../src/settings-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAE9D,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAG,2BAA2B,CAAA;AAE7D,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;IAC/D;;OAEG;IACH,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;IACxD;;;;OAIG;IACH,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,sBAAsB,CAAU,CAAC,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,WAAW,CAAC;IAC5K,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC,gBAAgB,CAAC;IAChF,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC,iBAAiB,CAAC;IAClF,8CAA8C;IAC9C,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC,gBAAgB,CAAC;IAChF,kDAAkD;IAClD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC,eAAe,CAAC;IAC7E,gDAAgD;IAChD,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC,YAAY,CAAC;IACxE,8CAA8C;IAC9C,gDAAgD;IAChD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC,MAAM,CAAC;IAC3D,iBAAiB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAU,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,iBAAiB,CAAC;IAC1H,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,gBAAgB,CAAC;IACtF,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC,cAAc,CAAC;IAC3E,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,kBAAkB,CAAC;IAClG,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,kBAAkB,CAAC;IAC1G,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,kBAAkB,CAAC;IACjH,eAAe,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,eAAe,CAAC;IAC3G,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,UAAU,CAAC;IAC1F,2CAA2C;IAC3C,kBAAkB;IAClB,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,mBAAmB,CAAC;IAC7G,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAU,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,UAAU,CAAC;IACtG,qCAAqC;IACrC,2CAA2C;IAC3C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,gBAAgB,CAAC;IAC7F,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,eAAe,CAAC;IAC5F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,WAAW,CAAC;IAC5F,4CAA4C;IAC5C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,eAAe,CAAC;IAC9G,gEAAgE;IAChE,uDAAuD;IACvD,4BAA4B;IAC5B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,eAAe,CAAC;IAC9F,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,MAAM,CAAU,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,cAAc,CAAC;IAC1G,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,wBAAwB,CAAC,WAAW,CAAC;IACrE,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,wBAAwB,CAAC,eAAe,CAAC;CAC5G,CAAC,CAAC,CAAA"}
+{"version":3,"file":"settings-schema.js","sourceRoot":"","sources":["../../src/settings-schema.ts"],"names":[],"mappings":"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"}

package/lib/types/settings-volatile.d.ts

@@ -24,14 +24,14 @@
  * if (form === void 0) return [];        // ← 一个字段都投影不出来，整条 entry 不会进 describe()
  * ```
  *
- * 我们的字段全是普通的 `.default(...)`，既不是 object 也不是 volatile，于是全部落到
+ * 可编辑业务字段如果只用普通的 `.default(...)`，既不是 object 也不是 volatile，就会落到
  * 出口 ③，整条 entry 被丢掉，客户端就只剩下 `unavailable`。核心插件的写法都带
  * `.volatile()`（`z.string().volatile()`、`z.number().default(10).volatile()`），
  * 这就是那条约定。
  *
  * ## 为什么这里统一标，而不是逐个手写
  *
- * 三个设置 schema 一共 40 多个字段；逐个加 `.volatile()` 既啰嗦，又会漏 —— 而**漏一个
+ * 可编辑设置字段有 40 多个；逐个加 `.volatile()` 既啰嗦，又会漏 —— 而**漏一个
  * 字段的后果是那个设置项在界面上直接消失**，属于沉默的失败。统一包一层让「新增字段
  * 默认可见」成为默认行为，想让它不可见才需要显式说明。
  *
@@ -59,7 +59,7 @@ export declare function volatileFields<T extends Record<string, Schemastery>>(fi
 /**
  * volatile 字段解包。
  *
- * 0.1.7 的设置字段**全部标了 `.volatile()`**（理由见 `settings-volatile.ts`），而
+ * 0.1.7 起可编辑的业务设置字段标为 `.volatile()`；固定配置字段不标。
  * schemastery 对 volatile 字段解析出来的**不是值，是一个引用** —— `{ get(), set() }`。
  * 核心插件也是这么用的：`dsh-agent-default-model` 读的是 `this.config.provider.get()`。
  *
@@ -78,7 +78,7 @@ export declare function unwrapVolatile<T>(value: unknown): T | undefined;
  * ## 为什么需要两层
  *
  * entry config 的形状是固定的 `{ 组名: { 字段: 引用 } }`（见 `config-schema.ts` 的
- * `knowledge` / `intent` / `convert` 三组），而只解一层的结果是「组本身还是原始对象、
+ * `knowledge` / `convert` / `behaviorRules` 三组），而只解一层的结果是「组本身还是原始对象、
  * 组里的字段还是引用」。
  *
  * 0029 实测到的故障就是这样来的：`intent` 组被原样交给 `applyIntent`，于是

package/lib/types/settings-volatile.js

@@ -24,14 +24,14 @@
  * if (form === void 0) return [];        // ← 一个字段都投影不出来，整条 entry 不会进 describe()
  * ```
  *
- * 我们的字段全是普通的 `.default(...)`，既不是 object 也不是 volatile，于是全部落到
+ * 可编辑业务字段如果只用普通的 `.default(...)`，既不是 object 也不是 volatile，就会落到
  * 出口 ③，整条 entry 被丢掉，客户端就只剩下 `unavailable`。核心插件的写法都带
  * `.volatile()`（`z.string().volatile()`、`z.number().default(10).volatile()`），
  * 这就是那条约定。
  *
  * ## 为什么这里统一标，而不是逐个手写
  *
- * 三个设置 schema 一共 40 多个字段；逐个加 `.volatile()` 既啰嗦，又会漏 —— 而**漏一个
+ * 可编辑设置字段有 40 多个；逐个加 `.volatile()` 既啰嗦，又会漏 —— 而**漏一个
  * 字段的后果是那个设置项在界面上直接消失**，属于沉默的失败。统一包一层让「新增字段
  * 默认可见」成为默认行为，想让它不可见才需要显式说明。
  *
@@ -59,7 +59,7 @@ export function volatileFields(fields) {
 /**
  * volatile 字段解包。
  *
- * 0.1.7 的设置字段**全部标了 `.volatile()`**（理由见 `settings-volatile.ts`），而
+ * 0.1.7 起可编辑的业务设置字段标为 `.volatile()`；固定配置字段不标。
  * schemastery 对 volatile 字段解析出来的**不是值，是一个引用** —— `{ get(), set() }`。
  * 核心插件也是这么用的：`dsh-agent-default-model` 读的是 `this.config.provider.get()`。
  *
@@ -83,7 +83,7 @@ export function unwrapVolatile(value) {
  * ## 为什么需要两层
  *
  * entry config 的形状是固定的 `{ 组名: { 字段: 引用 } }`（见 `config-schema.ts` 的
- * `knowledge` / `intent` / `convert` 三组），而只解一层的结果是「组本身还是原始对象、
+ * `knowledge` / `convert` / `behaviorRules` 三组），而只解一层的结果是「组本身还是原始对象、
  * 组里的字段还是引用」。
  *
  * 0029 实测到的故障就是这样来的：`intent` 组被原样交给 `applyIntent`，于是

package/lib/types/source-evidence.d.ts

@@ -0,0 +1,14 @@
+import type { Knowledge } from './knowledge.js';
+import type { KnowledgeDb } from './store/knowledge-db.js';
+/** Checking an evidence anchor does not establish whether a claim is true. */
+/**
+ * `bodies` 是可选的**来源正文预读**（documentId → 当前版本与正文）。批量路径（物化快照）
+ * 一次读完全部来源再传进来，于是每条知识不再各自 join 一次 blob、各做一次整份文档的
+ * flatten 与子串匹配 —— 那是 O(知识条数 × 文档大小)。不传时退回按需读取（单条判定）。
+ */
+export declare function assessKnowledgeEvidence(knowledge: Knowledge, db: KnowledgeDb, bodies?: ReadonlyMap<string, {
+    version: number;
+    content: string;
+}>): Knowledge;
+export declare function hasCurrentSupport(knowledge: Knowledge): boolean;
+//# sourceMappingURL=source-evidence.d.ts.map

package/lib/types/source-evidence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-evidence.d.ts","sourceRoot":"","sources":["../../src/source-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAmB,MAAM,gBAAgB,CAAA;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAE1D,8EAA8E;AAC9E;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,SAAS,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAK5J;AAmBD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAG/D"}

package/lib/types/source-evidence.js

@@ -0,0 +1,36 @@
+/** Checking an evidence anchor does not establish whether a claim is true. */
+/**
+ * `bodies` 是可选的**来源正文预读**（documentId → 当前版本与正文）。批量路径（物化快照）
+ * 一次读完全部来源再传进来，于是每条知识不再各自 join 一次 blob、各做一次整份文档的
+ * flatten 与子串匹配 —— 那是 O(知识条数 × 文档大小)。不传时退回按需读取（单条判定）。
+ */
+export function assessKnowledgeEvidence(knowledge, db, bodies) {
+    return {
+        ...knowledge,
+        sources: knowledge.sources.map(source => assessSource(source, db, bodies)),
+    };
+}
+function assessSource(source, db, bodies) {
+    if (source.withdrawn)
+        return { ...source, evidenceStatus: 'historical', quoteInCurrentVersion: false };
+    if (!source.documentId)
+        return { ...source, evidenceStatus: 'human' };
+    const head = bodies?.get(source.documentId) ?? db.source(source.documentId);
+    if (!head)
+        return { ...source, evidenceStatus: 'missing', quoteInCurrentVersion: false };
+    const content = 'record' in head ? head.record.content : head.content;
+    const flatten = (text) => text.replace(/\s+/g, '');
+    const quote = flatten(source.quote);
+    return {
+        ...source,
+        currentVersion: head.version,
+        evidenceStatus: source.toVersion === undefined ? 'unversioned'
+            : source.toVersion === head.version ? 'current' : 'historical',
+        quoteInCurrentVersion: quote !== '' && flatten(content).includes(quote),
+    };
+}
+export function hasCurrentSupport(knowledge) {
+    return knowledge.sources.some(source => source.evidenceStatus === 'human'
+        || (source.evidenceStatus === 'current' && source.quoteInCurrentVersion === true));
+}
+//# sourceMappingURL=source-evidence.js.map

package/lib/types/source-evidence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source-evidence.js","sourceRoot":"","sources":["../../src/source-evidence.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E;;;;GAIG;AACH,MAAM,UAAU,uBAAuB,CAAC,SAAoB,EAAE,EAAe,EAAE,MAAkE;IAC/I,OAAO;QACL,GAAG,SAAS;QACZ,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;KAC3E,CAAA;AACH,CAAC;AAED,SAAS,YAAY,CAAC,MAAuB,EAAE,EAAe,EAAE,MAAkE;IAChI,IAAI,MAAM,CAAC,SAAS;QAAE,OAAO,EAAE,GAAG,MAAM,EAAE,cAAc,EAAE,YAAY,EAAE,qBAAqB,EAAE,KAAK,EAAE,CAAA;IACtG,IAAI,CAAC,MAAM,CAAC,UAAU;QAAE,OAAO,EAAE,GAAG,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,CAAA;IACrE,MAAM,IAAI,GAAG,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IAC3E,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,GAAG,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,qBAAqB,EAAE,KAAK,EAAE,CAAA;IACxF,MAAM,OAAO,GAAG,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAA;IACrE,MAAM,OAAO,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;IAClE,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACnC,OAAO;QACL,GAAG,MAAM;QACT,cAAc,EAAE,IAAI,CAAC,OAAO;QAC5B,cAAc,EAAE,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,aAAa;YAC5D,CAAC,CAAC,MAAM,CAAC,SAAS,KAAK,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY;QAChE,qBAAqB,EAAE,KAAK,KAAK,EAAE,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC;KACxE,CAAA;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAoB;IACpD,OAAO,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,cAAc,KAAK,OAAO;WACpE,CAAC,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,MAAM,CAAC,qBAAqB,KAAK,IAAI,CAAC,CAAC,CAAA;AACtF,CAAC"}

package/lib/types/store/axis-references.d.ts

@@ -0,0 +1,5 @@
+import type { AxisKind } from '../axis-registry.js';
+import type { KnowledgeDb } from './knowledge-db.js';
+/** Runs inside the axis merge transaction on the same validated connection. */
+export declare function redirectAxisReferences(db: KnowledgeDb, kind: AxisKind, fromId: string, intoId: string): void;
+//# sourceMappingURL=axis-references.d.ts.map

package/lib/types/store/axis-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"axis-references.d.ts","sourceRoot":"","sources":["../../../src/store/axis-references.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAGnD,OAAO,KAAK,EAAE,WAAW,EAAoB,MAAM,mBAAmB,CAAA;AAEtE,+EAA+E;AAC/E,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAwF5G"}

package/lib/types/store/axis-references.js

@@ -0,0 +1,106 @@
+import { createHash } from 'node:crypto';
+import { compositeEventIdentity, eventEntityFromRecords, stripEventReferenceSection } from '../events.js';
+import { cardCoordinateKey } from '../types.js';
+/** Runs inside the axis merge transaction on the same validated connection. */
+export function redirectAxisReferences(db, kind, fromId, intoId) {
+    const column = { object: 'object_id', action: 'action_id', scene: 'scene_id' }[kind];
+    const field = { object: 'objectId', action: 'actionId', scene: 'sceneId' }[kind];
+    const redirect = (coordinate) => ({
+        ...coordinate, [field]: coordinate[field] === fromId ? intoId : coordinate[field],
+    });
+    const hasKnowledge = db.raw("SELECT 1 FROM sqlite_master WHERE name = 'knowledge'").get();
+    if (hasKnowledge)
+        db.raw(`UPDATE knowledge SET ${column} = ?, updated_at = ? WHERE ${column} = ?`).run(intoId, new Date().toISOString(), fromId);
+    const placements = db.placements();
+    const cards = db.cards();
+    const byCoordinate = new Map(cards.filter(row => row.card.coordinate).map(row => [cardCoordinateKey(row.card.coordinate), row]));
+    db.transact({ opId: `axis-merge:${fromId}:${intoId}:${Date.now()}`, actor: 'user', summary: '合并轴实体并迁移知识、卡片与事件引用' }, tx => {
+        for (const row of cards) {
+            const coordinate = row.card.coordinate;
+            if (!coordinate || coordinate[field] !== fromId)
+                continue;
+            const next = redirect(coordinate);
+            const key = cardCoordinateKey(next);
+            const target = byCoordinate.get(key);
+            const base = target && target.card.entityId !== row.card.entityId ? target : row;
+            const merged = base !== row;
+            const eventRefs = [...new Set([...db.cardEventIds(base.card.entityId), ...db.cardEventIds(row.card.entityId)])];
+            const card = {
+                ...base.card, coordinate: next,
+                content: stripEventReferenceSection(merged ? `${base.card.content}\n\n${row.card.content}` : row.card.content),
+                sourceRefs: [...new Set([...base.card.sourceRefs, ...row.card.sourceRefs])],
+                annotations: [...new Map([...(base.card.annotations ?? []), ...(row.card.annotations ?? [])].map(annotation => [annotation.id, annotation])).values()],
+                metadata: { ...base.card.metadata, layout: undefined, citations: undefined,
+                    aliases: [...new Set([...(Array.isArray(base.card.metadata.aliases) ? base.card.metadata.aliases : []), ...(Array.isArray(row.card.metadata.aliases) ? row.card.metadata.aliases : []), base.card.title, row.card.title])],
+                    ...(eventRefs.length ? { event_refs: JSON.stringify(eventRefs) } : {}) },
+            };
+            const rows = [...(placements.get(base.card.entityId) ?? []), ...(merged ? placements.get(row.card.entityId) ?? [] : [])];
+            const combined = [...new Map(rows.map(placement => [placement.knowledgeId, placement])).values()];
+            if (merged)
+                tx.removeEntity('card', row.card.entityId);
+            const frontmatter = { ...base.frontmatter, coordinate: { object: next.objectId, action: next.actionId, scene: next.sceneId }, source_refs: card.sourceRefs, metadata: card.metadata, annotations: card.annotations };
+            tx.putCard(card, frontmatter, { actor: 'user', kind: 'named', summary: '轴合并后的卡片引用' }, combined, true);
+            db.setCardEvents(card.entityId, eventRefs);
+            byCoordinate.delete(cardCoordinateKey(coordinate));
+            byCoordinate.set(key, { ...base, card, frontmatter });
+            placements.set(card.entityId, combined);
+        }
+        const changed = new Set();
+        const events = db.events().map(event => {
+            if (event.coordinateIds[field] !== fromId && !event.records.some(record => record.coordinateIds[field] === fromId))
+                return event;
+            changed.add(event.id);
+            return { ...event, coordinateIds: redirect(event.coordinateIds), records: event.records.map(record => ({ ...record, coordinateIds: redirect(record.coordinateIds) })), updatedAt: new Date().toISOString() };
+        });
+        const externalBases = new Map(events.filter(event => event.identityType === 'external_id' && !event.identityKey.includes(':coordinate:')).map(event => [event.identityKey, event]));
+        const groups = new Map();
+        for (const event of events) {
+            let key = event.identityKey;
+            if (changed.has(event.id) && event.identityType === 'composite')
+                key = compositeEventIdentity(event.occurredAt, event.coordinateIds, event.symptom);
+            if (event.identityType === 'external_id' && key.includes(':coordinate:')) {
+                const baseKey = key.slice(0, key.indexOf(':coordinate:'));
+                const base = externalBases.get(baseKey);
+                if (base && cardCoordinateKey(base.coordinateIds) === cardCoordinateKey(event.coordinateIds))
+                    key = baseKey;
+                else if (changed.has(event.id))
+                    key = baseKey + ':coordinate:' + createHash('sha256').update(JSON.stringify(event.coordinateIds)).digest('hex').slice(0, 24);
+            }
+            const group = groups.get(key) ?? [];
+            group.push(event);
+            groups.set(key, group);
+        }
+        const redirects = new Map();
+        const affectedCards = new Set();
+        for (const [key, group] of groups) {
+            if (group.length === 1 && !changed.has(group[0].id) && key === group[0].identityKey)
+                continue;
+            const target = group.find(event => event.identityKey === key) ?? group[0];
+            const records = [...new Map(group.flatMap(event => event.records).map(record => [`${record.sourceId}\u0001${record.localId}`, record])).values()];
+            for (const event of group) {
+                if (event.id === target.id)
+                    continue;
+                redirects.set(event.id, target.id);
+                for (const row of db.raw('SELECT card_id FROM card_event WHERE event_id = ?').all(event.id))
+                    affectedCards.add(row.card_id);
+                db.raw(`INSERT OR IGNORE INTO card_event(card_id, event_id, ordinal)
+          SELECT card_id, ?, ordinal FROM card_event WHERE event_id = ?`).run(target.id, event.id);
+                db.removeEvent(event.id);
+            }
+            db.writeEvent(group.length === 1 ? { ...target, identityKey: key } : eventEntityFromRecords({ ...target, identityKey: key, records }));
+        }
+        if (redirects.size) {
+            for (const row of db.cards()) {
+                let content = stripEventReferenceSection(row.card.content);
+                for (const [from, into] of redirects)
+                    content = content.replaceAll(from, into);
+                if (content === row.card.content && !affectedCards.has(row.card.entityId))
+                    continue;
+                const metadata = { ...row.card.metadata, event_refs: JSON.stringify(db.cardEventIds(row.card.entityId)) };
+                const frontmatter = { ...row.frontmatter, metadata };
+                tx.putCard({ ...row.card, content, metadata }, frontmatter, { actor: 'user', kind: 'named', summary: '轴合并后的 Event 引用' });
+            }
+        }
+    });
+}
+//# sourceMappingURL=axis-references.js.map

package/lib/types/store/axis-references.js.map

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

package/lib/types/store/derived.d.ts

@@ -65,6 +65,15 @@ export interface FtsDocument {
     title: string;
     content: string;
 }
+export interface DerivedPublication {
+    artifacts: Map<string, string>;
+    fts?: FtsDocument[];
+    vectors?: {
+        manifest: unknown;
+        binary: Buffer;
+        int8: Buffer;
+    } | null;
+}
 export type DerivedOpenResult = {
     ok: true;
     db: DerivedDb; /** 这次开库是否把旧结构整体重建了。 */
@@ -105,6 +114,8 @@ export declare class DerivedDb {
     artifactHash(name: string): string | undefined;
     artifactNames(): string[];
     putArtifact(name: string, body: string): void;
+    /** Model calls finish before this short transaction starts. */
+    publish(publication: DerivedPublication): void;
     removeArtifact(name: string): void;
     /**
      * 向量索引：一行，两个裸缓冲。
@@ -134,7 +145,7 @@ export declare class DerivedDb {
      * 查询语法错误或索引损坏时**返回空数组而不抛**：关键词路是三条召回路线之一，
      * 它挂了不该把整次召回带走 —— 调用方在诊断里如实说明这一路没结果。
      */
-    searchFts(query: string, limit: number): FtsHit[];
+    searchFts(query: string, limit: number, eligible?: ReadonlySet<string>): FtsHit[];
     /** 一句话说清这个库现在有什么。界面与诊断用。 */
     summary(): {
         artifacts: number;

package/lib/types/store/derived.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"derived.d.ts","sourceRoot":"","sources":["../../../src/store/derived.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,WAAW,CAAA;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AAE9C,mDAAmD;AACnD,OAAO,EAAE,eAAe,EAAE,CAAA;AAE1B;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,aAAa,CAAA;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,IAAI,CAAA;AAElC;;;;;;GAMG;AACH,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACd;AAED,kDAAkD;AAClD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,iBAAiB,GACzB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,EAAE,EAAE,SAAS,CAAC,CAAC,uBAAuB;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACrE;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,kBAAkB,GAAG,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAsC5E;;GAEG;AACH,qBAAa,SAAS;IACA,OAAO,CAAC,QAAQ,CAAC,EAAE;IAAkB,QAAQ,CAAC,IAAI,EAAE,MAAM;IAA9E,OAAO;IAEP;;;;;;;;;;;;;;OAcG;WACU,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,IAAI,EAAE,MAAM,KAAK,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0C/G,KAAK,IAAI,IAAI;IAIb,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe;IAEjC,qCAAqC;IACrC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK1C,8CAA8C;IAC9C,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAK9C,aAAa,IAAI,MAAM,EAAE;IAKzB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAK7C,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlC;;;;;OAKG;IACH,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAKrE,WAAW,IAAI;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS;IAQ9E;;;;;;OAMG;IACH,UAAU,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,IAAI;IA4B1C,4CAA4C;IAC5C,MAAM,IAAI,OAAO;IAKjB;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAkBjD,4BAA4B;IAC5B,OAAO,IAAI;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE;CAMvE"}
+{"version":3,"file":"derived.d.ts","sourceRoot":"","sources":["../../../src/store/derived.ts"],"names":[],"mappings":"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"}