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

package/lib/types/agent-behavior-rules.d.ts

@@ -0,0 +1,10 @@
+export interface AgentBehaviorRuleSet {
+    id: string;
+    label: string;
+    rules: readonly string[];
+}
+export declare const AGENT_BEHAVIOR_RULE_SETS: readonly AgentBehaviorRuleSet[];
+/** Return the exact prompt fragment for Standard mode; other presets get no additions. */
+export declare function behaviorRulesForPreset(presetId: unknown): string;
+export declare function behaviorPromptForPreset(presetId: unknown, enabled?: boolean): string;
+//# sourceMappingURL=agent-behavior-rules.d.ts.map

package/lib/types/agent-behavior-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-behavior-rules.d.ts","sourceRoot":"","sources":["../../src/agent-behavior-rules.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CACzB;AAED,eAAO,MAAM,wBAAwB,EAAE,SAAS,oBAAoB,EAEnE,CAAA;AAED,0FAA0F;AAC1F,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAIhE;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,UAAO,GAAG,MAAM,CAEjF"}

package/lib/types/agent-behavior-rules.js

@@ -0,0 +1,28 @@
+import { STANDARD_PRESET_ID } from './preset-ids.js';
+/** Rules added to DSH Standard mode. Keep this list as the UI and prompt source of truth. */
+const STANDARD_RULES = [
+    '数据或知识任务开始时调用 `intent_record`；寒暄、闲聊、纯写作、代码和一般运维任务不记录。',
+    '组织内部的定义、指标口径、规则、流程和历史优先查内部知识；用户提供的材料直接读取。来源冲突或需要原文时查源文档。',
+    '不要编造事实或数字。结论使用可追溯且仍适用的工具结果或用户材料；关键指标说明计算口径，影响结论的不确定性必须说明。数据过期、范围改变或证据不足时，先补查再下结论。',
+    '复用已确认的 ID；目标或 ID 未知时先查目录或数据字典。优先用工具查明知识和数据；只有目标、选择或授权确实无法查明时才向用户确认。只调用与当前任务有关的工具。',
+    '报告、表格、图表等交付文件放在当前会话工作区的 `output/<YYYY-MM-DD>/`，日期取本地日期；给出实际路径。代码仓库源文件留在仓库原位置。',
+    '交付文件使用有含义的中文名，名称部分不超过 25 字；只保留汉字、字母、数字和 `-_.`，其他字符替换成 `-`。文件名不重复写日期，不覆盖已有文件，重名时追加 `-2`、`-3`。',
+    '确认操作成功后再报告完成；后台任务已提交不代表已完成。',
+    '使用用户的语言，默认中文；先说结论，再给必要依据和来源。用常见词和短句，解释必要术语，删掉套话和重复。只在有助理解时使用标题、列表或表格。',
+    '知识库只通过知识工具读写，且只执行用户已要求或已授权的写入。转换、入库和编译是独立步骤；默认导入只保存来源，编译需明确要求。',
+    'Wiki Fact 与 Wiki Way 由编译器维护；先明确当前子问题，再检索可用 Procedure。命中章节用于定位，采用时读取完整 Wiki 的条件与边界。历史 Case 只证明当时的过程和结果，不能直接作为当前根因；审核由人完成。',
+];
+export const AGENT_BEHAVIOR_RULE_SETS = [
+    { id: STANDARD_PRESET_ID, label: '标准模式', rules: STANDARD_RULES },
+];
+/** Return the exact prompt fragment for Standard mode; other presets get no additions. */
+export function behaviorRulesForPreset(presetId) {
+    const ruleSet = AGENT_BEHAVIOR_RULE_SETS.find(item => item.id === presetId);
+    if (!ruleSet)
+        return '';
+    return [`## 数据与知识任务规则（${ruleSet.label}）`, ...ruleSet.rules.map(rule => `- ${rule}`)].join('\n');
+}
+export function behaviorPromptForPreset(presetId, enabled = true) {
+    return enabled ? behaviorRulesForPreset(presetId) : '';
+}
+//# sourceMappingURL=agent-behavior-rules.js.map

package/lib/types/agent-behavior-rules.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-behavior-rules.js","sourceRoot":"","sources":["../../src/agent-behavior-rules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEpD,6FAA6F;AAC7F,MAAM,cAAc,GAAG;IACrB,sDAAsD;IACtD,0DAA0D;IAC1D,mFAAmF;IACnF,mFAAmF;IACnF,+EAA+E;IAC/E,8FAA8F;IAC9F,6BAA6B;IAC7B,uEAAuE;IACvE,gEAAgE;IAChE,0HAA0H;CAClH,CAAA;AAQV,MAAM,CAAC,MAAM,wBAAwB,GAAoC;IACvE,EAAE,EAAE,EAAE,kBAAkB,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE;CACjE,CAAA;AAED,0FAA0F;AAC1F,MAAM,UAAU,sBAAsB,CAAC,QAAiB;IACtD,MAAM,OAAO,GAAG,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAA;IAC3E,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAA;IACvB,OAAO,CAAC,gBAAgB,OAAO,CAAC,KAAK,GAAG,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACjG,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,QAAiB,EAAE,OAAO,GAAG,IAAI;IACvE,OAAO,OAAO,CAAC,CAAC,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AACxD,CAAC"}

package/lib/types/axis-registry.d.ts

@@ -34,11 +34,24 @@
  * ## 为什么存在记忆段
  *
  * 注册表**不可重建**：它是人确认过的命名决定（改 canonical name、并两个实体、加一个别名），
- * 重跑一次抽取不会得到同样的结果。所以它和操作日志、抽取轨迹一样落在
- * `<memoryDir>/knowledge.sqlite`，不在 `03_compiled/`。
+ * 重跑一次抽取不会得到同样的结果。所以它与 Knowledge 共享 `knowledge.db`，
+ * 经过同一个属主与 schema 版本入口校验。
  */
+import { type SqliteDatabase } from './fts.js';
 /** 三个轴。三者地位相同（§3.1）—— 没有哪个更特殊。 */
 export type AxisKind = 'object' | 'action' | 'scene';
+/** 当前参与关系扩展召回的轴关系。它连接相关对象，不表示父子层级。 */
+export declare const AXIS_RELATION_TYPES: readonly ["related_to"];
+export type AxisRelationType = typeof AXIS_RELATION_TYPES[number];
+export interface AxisRelation {
+    id: string;
+    fromId: string;
+    toId: string;
+    relationType: AxisRelationType;
+    evidence: string;
+    createdAt: string;
+    updatedAt: string;
+}
 /**
  * 一个轴实体的状态。
  *
@@ -139,9 +152,19 @@ export declare function axisId(kind: AxisKind, name: string): string;
  */
 export declare class AxisRegistry {
     private readonly file;
+    private readonly shared?;
     private db;
-    constructor(file: string);
+    private owner;
+    constructor(file: string, shared?: SqliteDatabase | undefined);
     open(): Promise<boolean>;
+    inputRevision(): number;
+    /** Resolve against an isolated copy; commit only if the live registry still matches. */
+    draft(): Promise<{
+        registry: AxisRegistry;
+        commit: () => void;
+        close: () => void;
+    }>;
+    private changedInput;
     available(): boolean;
     /**
      * 把一个 mention 解析成 canonical 实体。
@@ -187,6 +210,12 @@ export declare class AxisRegistry {
     list(kind?: AxisKind, status?: AxisStatus): Promise<Array<AxisEntity & {
         aliases: string[];
     }>>;
+    /** 列出对象关系；传实体 id 时只返回它的邻接关系。 */
+    listRelations(entityId?: string): Promise<AxisRelation[]>;
+    /** 建立无方向的 related_to 边；同一个对象不能关联自己。 */
+    addRelation(fromId: string, toId: string, evidence?: string): Promise<AxisRelation | null>;
+    /** 移除一条对象关系。 */
+    removeRelation(id: string): Promise<boolean>;
     /** 每个轴各有多少个实体、其中几个待人确认。类型定义那一屏的计数读它。 */
     stats(): Promise<Record<AxisKind, {
         total: number;
@@ -212,7 +241,9 @@ export declare class AxisRegistry {
      * 它转成 `merged`，`scopeId` 改存目标 id —— 复用这一列而不是新加一列，因为
      * 「它现在归谁」与「它在谁的下面」对解析来说问的是同一件事。
      */
-    merge(fromId: string, intoId: string): Promise<boolean>;
+    merge(fromId: string, intoId: string, redirect?: (kind: AxisKind) => void): Promise<boolean>;
+    /** 合并轴实体时转移相关关系，并折叠重复边与自环。 */
+    private redirectRelations;
     /**
      * 人改定义。**写了就是决定**：`description_source` 落成 `human`，模型从此不许覆盖。
      */
@@ -277,7 +308,8 @@ export declare class AxisRegistry {
     }>;
     close(): void;
     private findCanonical;
-    private findAlias;
+    /** 作用域内的别名命中。**可能不止一条** —— 调用方必须自己判唯一性。 */
+    private findAliases;
     /** 全局 canonical 名精确命中。它可能不止一个 —— 两个实体同名时就是歧义。 */
     private findCanonicalGlobal;
     /**

package/lib/types/axis-registry.d.ts.map

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

package/lib/types/axis-registry.js

@@ -34,12 +34,14 @@
  * ## 为什么存在记忆段
  *
  * 注册表**不可重建**：它是人确认过的命名决定（改 canonical name、并两个实体、加一个别名），
- * 重跑一次抽取不会得到同样的结果。所以它和操作日志、抽取轨迹一样落在
- * `<memoryDir>/knowledge.sqlite`，不在 `03_compiled/`。
+ * 重跑一次抽取不会得到同样的结果。所以它与 Knowledge 共享 `knowledge.db`，
+ * 经过同一个属主与 schema 版本入口校验。
  */
-import { mkdir } from 'node:fs/promises';
-import { dirname } from 'node:path';
+import { createHash } from 'node:crypto';
 import { loadSqlite } from './fts.js';
+import { KnowledgeDb } from './store/knowledge-db.js';
+/** 当前参与关系扩展召回的轴关系。它连接相关对象，不表示父子层级。 */
+export const AXIS_RELATION_TYPES = ['related_to'];
 export const AXIS_GUIDANCE_KINDS = ['prefer_name', 'do_not_merge', 'scope_rule', 'definition', 'extraction_hint'];
 /**
  * 轴名归一：全半角、大小写、空格、连接符。
@@ -119,6 +121,18 @@ CREATE TABLE IF NOT EXISTS entity_guidance (
   created_at TEXT NOT NULL
 );
 CREATE INDEX IF NOT EXISTS idx_axis_guidance_entity ON entity_guidance(entity_id);
+CREATE TABLE IF NOT EXISTS axis_relations (
+  id TEXT PRIMARY KEY,
+  from_id TEXT NOT NULL,
+  to_id TEXT NOT NULL,
+  relation_type TEXT NOT NULL,
+  evidence TEXT NOT NULL DEFAULT '',
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE(from_id, to_id, relation_type)
+);
+CREATE INDEX IF NOT EXISTS idx_axis_relation_from ON axis_relations(from_id, relation_type);
+CREATE INDEX IF NOT EXISTS idx_axis_relation_to ON axis_relations(to_id, relation_type);
 `;
 /**
  * 三个轴共用一个注册表。
@@ -128,9 +142,12 @@ CREATE INDEX IF NOT EXISTS idx_axis_guidance_entity ON entity_guidance(entity_id
  */
 export class AxisRegistry {
     file;
+    shared;
     db = null;
-    constructor(file) {
+    owner = null;
+    constructor(file, shared) {
         this.file = file;
+        this.shared = shared;
     }
     async open() {
         if (this.db !== null)
@@ -139,12 +156,20 @@ export class AxisRegistry {
         if (sqlite === null)
             return false;
         try {
-            await mkdir(dirname(this.file), { recursive: true });
-            this.db = new sqlite.DatabaseSync(this.file);
+            if (this.shared)
+                this.db = this.shared;
+            else {
+                const opened = await KnowledgeDb.open(this.file, sqlite.DatabaseSync);
+                if (!opened.ok)
+                    return false;
+                this.owner = opened.db;
+                this.db = opened.db.connection();
+            }
             this.db.exec(SCHEMA);
+            this.db.exec('CREATE TABLE IF NOT EXISTS axis_input_revision (id INTEGER PRIMARY KEY CHECK(id = 1), revision INTEGER NOT NULL); INSERT OR IGNORE INTO axis_input_revision VALUES (1, 0)');
             /*
-             * 补列。这个库**没有 `user_version` 那一套**（它是记忆段里的一张注册表，不是知识本体），
-             * 所以判据落在列上：缺就补，补齐之后什么都不做。`CREATE TABLE IF NOT EXISTS` 对
+             * 主库已通过 `user_version` 校验，再幂等补齐存量注册表的扩展列。缺就补。
+             * `CREATE TABLE IF NOT EXISTS` 对
              * 已经存在的表一个字都不改 —— 少了这一段，0068 之前建的库会永远没有这两列，
              * 而症状是「定义存进去了，下次打开又没了」。
              */
@@ -157,10 +182,61 @@ export class AxisRegistry {
             return true;
         }
         catch {
+            this.owner?.close();
+            this.owner = null;
             this.db = null;
             return false;
         }
     }
+    inputRevision() {
+        return Number(this.db?.prepare('SELECT revision FROM axis_input_revision WHERE id = 1').get()?.revision ?? 0);
+    }
+    /** Resolve against an isolated copy; commit only if the live registry still matches. */
+    async draft() {
+        const sqlite = await loadSqlite();
+        if (!sqlite || !this.db)
+            throw new Error('AXIS_REGISTRY_UNAVAILABLE');
+        const live = this.db;
+        const tables = ['axis_entities', 'axis_aliases', 'entity_guidance', 'axis_relations', 'axis_input_revision'];
+        const read = (db) => tables.map(table => db.prepare(`SELECT * FROM ${table} ORDER BY rowid`).all());
+        const before = read(live);
+        const copy = new sqlite.DatabaseSync(':memory:');
+        const registry = new AxisRegistry(':memory:', copy);
+        try {
+            if (!await registry.open())
+                throw new Error('AXIS_DRAFT_UNAVAILABLE');
+            tables.forEach((table, index) => {
+                copy.exec(`DELETE FROM ${table}`);
+                for (const row of before[index]) {
+                    const columns = Object.keys(row);
+                    copy.prepare(`INSERT INTO ${table} (${columns.join(',')}) VALUES (${columns.map(() => '?').join(',')})`).run(...Object.values(row));
+                }
+            });
+            return {
+                registry,
+                commit: () => {
+                    if (JSON.stringify(read(live)) !== JSON.stringify(before))
+                        throw new Error('归一期间实体注册表已变化，请重试归一');
+                    // Resolution only adds entities/aliases and fills model definitions.
+                    for (const table of ['axis_entities', 'axis_aliases']) {
+                        for (const row of copy.prepare(`SELECT * FROM ${table}`).all()) {
+                            const columns = Object.keys(row);
+                            const keys = table === 'axis_entities' ? ['id'] : ['entity_id', 'normalized', 'scope_id'];
+                            const updates = columns.filter(column => !keys.includes(column)).map(column => `${column}=excluded.${column}`);
+                            live.prepare(`INSERT INTO ${table} (${columns.join(',')}) VALUES (${columns.map(() => '?').join(',')}) ON CONFLICT (${keys.join(',')}) DO UPDATE SET ${updates.join(',')}`).run(...Object.values(row));
+                        }
+                    }
+                },
+                close: () => { registry.close(); copy.close(); },
+            };
+        }
+        catch (cause) {
+            registry.close();
+            copy.close();
+            throw cause;
+        }
+    }
+    changedInput() { this.db?.prepare('UPDATE axis_input_revision SET revision = revision + 1 WHERE id = 1').run(); }
     available() {
         return this.db !== null;
     }
@@ -203,10 +279,19 @@ export class AxisRegistry {
         }
         // 2 · 作用域内 alias
         if (parentId) {
-            const aliased = this.findAlias(normalized, parentId);
-            if (aliased) {
-                this.learn(aliased, mention, normalized, parentId, input.description);
-                return { mention, normalized, outcome: 'matched', entity: aliased, how: 'scoped-alias' };
+            const aliased = this.findAliases(input.kind, normalized, parentId);
+            if (aliased.length === 1) {
+                this.learn(aliased[0], mention, normalized, parentId, input.description);
+                return { mention, normalized, outcome: 'matched', entity: aliased[0], how: 'scoped-alias' };
+            }
+            /**
+             * 同一作用域里两个实体可以合法地共有同一条别名（`axis_aliases` 的主键是
+             * `(entity_id, normalized, scope_id)`，不是 `(normalized, scope_id)`）。这时候
+             * **不能取第一个** —— 本文件的规矩是「不唯一就不猜」，猜错的代价是把一条知识挂到
+             * 错误的对象上并一路传到卡名。全局那条路（下面）一直是这么做的，只有这里漏了。
+             */
+            if (aliased.length > 1) {
+                return { mention, normalized, outcome: 'ambiguous', candidates: aliased.slice().sort((left, right) => left.name.localeCompare(right.name)) };
             }
         }
         /**
@@ -332,6 +417,64 @@ export class AxisRegistry {
             return { ...entity, aliases: aliases.map(item => String(item.alias)) };
         });
     }
+    /** 列出对象关系；传实体 id 时只返回它的邻接关系。 */
+    async listRelations(entityId) {
+        if (this.db === null)
+            throw new Error('AXIS_REGISTRY_UNAVAILABLE');
+        const params = {};
+        const filter = entityId === undefined ? '' : 'AND (r.from_id = :entityId OR r.to_id = :entityId)';
+        if (entityId !== undefined)
+            params.entityId = entityId;
+        const rows = this.db.prepare(`
+      SELECT r.* FROM axis_relations r
+      JOIN axis_entities a ON a.id = r.from_id
+      JOIN axis_entities b ON b.id = r.to_id
+      WHERE r.relation_type = 'related_to'
+        AND a.kind = 'object' AND b.kind = 'object'
+        AND a.status <> 'merged' AND b.status <> 'merged'
+        ${filter}
+      ORDER BY r.from_id, r.to_id
+    `).all(params);
+        return rows.map(rowToRelation);
+    }
+    /** 建立无方向的 related_to 边；同一个对象不能关联自己。 */
+    async addRelation(fromId, toId, evidence = '') {
+        if (this.db === null)
+            throw new Error('AXIS_REGISTRY_UNAVAILABLE');
+        if (!fromId || !toId || fromId === toId)
+            return null;
+        const [from, to] = await Promise.all([this.get(fromId), this.get(toId)]);
+        if (from === null || to === null || from.kind !== 'object' || to.kind !== 'object' || from.status === 'merged' || to.status === 'merged')
+            return null;
+        const [left, right] = [fromId, toId].sort((a, b) => a.localeCompare(b));
+        const now = new Date().toISOString();
+        const relation = {
+            id: axisRelationId(left, right, 'related_to'),
+            fromId: left,
+            toId: right,
+            relationType: 'related_to',
+            evidence: evidence.trim(),
+            createdAt: now,
+            updatedAt: now,
+        };
+        this.db.prepare(`
+      INSERT INTO axis_relations (id, from_id, to_id, relation_type, evidence, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(from_id, to_id, relation_type) DO UPDATE SET
+        evidence = CASE WHEN excluded.evidence <> '' THEN excluded.evidence ELSE axis_relations.evidence END,
+        updated_at = excluded.updated_at
+    `).run(relation.id, relation.fromId, relation.toId, relation.relationType, relation.evidence, relation.createdAt, relation.updatedAt);
+        const row = this.db.prepare('SELECT * FROM axis_relations WHERE from_id = ? AND to_id = ? AND relation_type = ?')
+            .get(left, right, 'related_to');
+        return row === undefined ? null : rowToRelation(row);
+    }
+    /** 移除一条对象关系。 */
+    async removeRelation(id) {
+        if (this.db === null)
+            throw new Error('AXIS_REGISTRY_UNAVAILABLE');
+        const result = this.db.prepare('DELETE FROM axis_relations WHERE id = ?').run(id);
+        return Number(result.changes) > 0;
+    }
     /** 每个轴各有多少个实体、其中几个待人确认。类型定义那一屏的计数读它。 */
     async stats() {
         const empty = { total: 0, candidate: 0 };
@@ -363,6 +506,7 @@ export class AxisRegistry {
         const now = new Date().toISOString();
         this.db.prepare('UPDATE axis_entities SET name = ?, updated_at = ? WHERE id = ?').run(next, now, id);
         this.insertAlias(id, current.name, normalizeAxisName(current.name), current.scopeId, now);
+        this.changedInput();
         return this.get(id);
     }
     /**
@@ -379,6 +523,7 @@ export class AxisRegistry {
         if (!normalized)
             return false;
         this.insertAlias(id, alias.trim(), normalized, scopeId.trim(), new Date().toISOString());
+        this.changedInput();
         return true;
     }
     /** 确认一个候选实体。人看过之后调它 —— 与卡片 review 同一条纪律：入库在前、确认在后。 */
@@ -389,6 +534,7 @@ export class AxisRegistry {
         if (this.db === null)
             throw new Error('AXIS_REGISTRY_UNAVAILABLE');
         this.db.prepare('UPDATE axis_entities SET status = ?, updated_at = ? WHERE id = ?').run(status, new Date().toISOString(), id);
+        this.changedInput();
         return this.get(id);
     }
     /**
@@ -398,22 +544,65 @@ export class AxisRegistry {
      * 它转成 `merged`，`scopeId` 改存目标 id —— 复用这一列而不是新加一列，因为
      * 「它现在归谁」与「它在谁的下面」对解析来说问的是同一件事。
      */
-    async merge(fromId, intoId) {
+    async merge(fromId, intoId, redirect) {
         if (this.db === null)
             throw new Error('AXIS_REGISTRY_UNAVAILABLE');
         if (fromId === intoId)
             return false;
         const [from, into] = [await this.get(fromId), await this.get(intoId)];
-        if (from === null || into === null || from.kind !== into.kind)
+        if (from === null || into === null || from.kind !== into.kind || from.status === 'merged' || into.status === 'merged')
             return false;
         const now = new Date().toISOString();
-        this.db.prepare('UPDATE axis_entities SET status = ?, scope_id = ?, updated_at = ? WHERE id = ?').run('merged', intoId, now, fromId);
-        // 被并者的别名与名字一起搬过去：按旧名、旧别名都要搜得到。
-        this.insertAlias(intoId, from.name, normalizeAxisName(from.name), into.scopeId, now);
-        const aliases = this.db.prepare('SELECT alias, scope_id FROM axis_aliases WHERE entity_id = ?').all(fromId);
-        for (const row of aliases)
-            this.insertAlias(intoId, String(row.alias), normalizeAxisName(String(row.alias)), String(row.scope_id ?? ''), now);
-        return true;
+        this.db.exec('SAVEPOINT axis_merge');
+        try {
+            this.db.prepare('UPDATE axis_entities SET status = ?, scope_id = ?, updated_at = ? WHERE id = ?').run('merged', intoId, now, fromId);
+            // 被并者的别名与名字一起搬过去：按旧名、旧别名都要搜得到。
+            this.insertAlias(intoId, from.name, normalizeAxisName(from.name), into.scopeId, now);
+            const aliases = this.db.prepare('SELECT alias, scope_id FROM axis_aliases WHERE entity_id = ?').all(fromId);
+            for (const row of aliases)
+                this.insertAlias(intoId, String(row.alias), normalizeAxisName(String(row.alias)), String(row.scope_id ?? ''), now);
+            this.redirectRelations(fromId, intoId, now);
+            redirect?.(from.kind);
+            // Scope references on both canonical names and aliases move together.
+            this.db.prepare("UPDATE axis_entities SET scope_id = ? WHERE scope_id = ? AND status <> 'merged'").run(intoId, fromId);
+            this.db.prepare(`INSERT OR IGNORE INTO axis_aliases (entity_id, alias, normalized, scope_id, created_at)
+        SELECT entity_id, alias, normalized, ?, created_at FROM axis_aliases WHERE scope_id = ?`).run(intoId, fromId);
+            this.db.prepare('DELETE FROM axis_aliases WHERE scope_id = ?').run(fromId);
+            this.db.prepare('UPDATE entity_guidance SET entity_id = ? WHERE entity_id = ?').run(intoId, fromId);
+            this.changedInput();
+            this.db.exec('RELEASE axis_merge');
+            return true;
+        }
+        catch (cause) {
+            this.db.exec('ROLLBACK TO axis_merge; RELEASE axis_merge');
+            throw cause;
+        }
+    }
+    /** 合并轴实体时转移相关关系，并折叠重复边与自环。 */
+    redirectRelations(fromId, intoId, now) {
+        if (this.db === null)
+            return;
+        const rows = this.db.prepare('SELECT * FROM axis_relations WHERE from_id = ? OR to_id = ?').all(fromId, fromId);
+        if (rows.length === 0)
+            return;
+        this.db.prepare('DELETE FROM axis_relations WHERE from_id = ? OR to_id = ?').run(fromId, fromId);
+        const insert = this.db.prepare(`
+      INSERT INTO axis_relations (id, from_id, to_id, relation_type, evidence, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?)
+      ON CONFLICT(from_id, to_id, relation_type) DO UPDATE SET
+        evidence = CASE WHEN excluded.evidence <> '' THEN excluded.evidence ELSE axis_relations.evidence END,
+        updated_at = excluded.updated_at
+    `);
+        for (const row of rows) {
+            const oldFrom = String(row.from_id);
+            const oldTo = String(row.to_id);
+            const pair = [oldFrom === fromId ? intoId : oldFrom, oldTo === fromId ? intoId : oldTo];
+            if (pair[0] === pair[1])
+                continue;
+            const [left, right] = pair.sort((a, b) => a.localeCompare(b));
+            const type = String(row.relation_type);
+            insert.run(axisRelationId(left, right, type), left, right, type, String(row.evidence ?? ''), String(row.created_at ?? now), now);
+        }
     }
     /* ─────────────────────────────────────────── 定义（0068） ── */
     /**
@@ -425,6 +614,7 @@ export class AxisRegistry {
         const next = text.trim();
         this.db.prepare('UPDATE axis_entities SET description = ?, description_source = ?, updated_at = ? WHERE id = ?')
             .run(next, next ? 'human' : '', new Date().toISOString(), id);
+        this.changedInput();
         return this.get(id);
     }
     /**
@@ -521,6 +711,7 @@ export class AxisRegistry {
         };
         this.db.prepare('INSERT INTO entity_guidance (id, entity_id, kind, text, author, created_at) VALUES (?, ?, ?, ?, ?, ?)')
             .run(guidance.id, guidance.entityId, guidance.kind, guidance.text, guidance.author, guidance.createdAt);
+        this.changedInput();
         return guidance;
     }
     /** 撤一条指导。**人写的东西要能撤** —— 不然一条写错的指引会永远跟着每次抽取。 */
@@ -531,6 +722,7 @@ export class AxisRegistry {
         if (before === undefined)
             return false;
         this.db.prepare('DELETE FROM entity_guidance WHERE id = ?').run(id);
+        this.changedInput();
         return true;
     }
     /**
@@ -614,7 +806,8 @@ export class AxisRegistry {
         return { entries, totals, truncated, selection };
     }
     close() {
-        this.db?.close();
+        this.owner?.close();
+        this.owner = null;
         this.db = null;
     }
     // ------------------------------------------------------------ 内部查询
@@ -623,9 +816,10 @@ export class AxisRegistry {
         const hit = rows.find(row => normalizeAxisName(String(row.name)) === normalized);
         return hit === undefined ? undefined : rowToEntity(hit);
     }
-    findAlias(normalized, scopeId) {
-        const row = this.db.prepare("SELECT e.* FROM axis_aliases a JOIN axis_entities e ON e.id = a.entity_id WHERE a.normalized = ? AND a.scope_id = ? AND e.status <> 'merged' LIMIT 1").get(normalized, scopeId);
-        return row === undefined ? undefined : rowToEntity(row);
+    /** 作用域内的别名命中。**可能不止一条** —— 调用方必须自己判唯一性。 */
+    findAliases(kind, normalized, scopeId) {
+        const rows = this.db.prepare("SELECT e.* FROM axis_aliases a JOIN axis_entities e ON e.id = a.entity_id WHERE a.normalized = ? AND a.scope_id = ? AND e.kind = ? AND e.status <> 'merged' ORDER BY e.id").all(normalized, scopeId, kind);
+        return rows.map(rowToEntity);
     }
     /** 全局 canonical 名精确命中。它可能不止一个 —— 两个实体同名时就是歧义。 */
     findCanonicalGlobal(kind, normalized) {
@@ -726,6 +920,20 @@ function rowToEntity(row) {
         updatedAt: String(row.updated_at),
     };
 }
+function axisRelationId(fromId, toId, relationType) {
+    return `axis_rel_${createHash('sha256').update(`${relationType}:${fromId}:${toId}`).digest('hex').slice(0, 14)}`;
+}
+function rowToRelation(row) {
+    return {
+        id: String(row.id),
+        fromId: String(row.from_id),
+        toId: String(row.to_id),
+        relationType: String(row.relation_type),
+        evidence: String(row.evidence ?? ''),
+        createdAt: String(row.created_at),
+        updatedAt: String(row.updated_at),
+    };
+}
 function rowToGuidance(row) {
     return {
         id: String(row.id),