@whispering233/ai-editor-server 0.0.53 → 0.0.55

package/dist/decompose/merge-write.d.ts

@@ -1,75 +0,0 @@
-import type { DecomposeBatchResult, EntitySummary } from "@whispering233/ai-editor-shared";
-import { type Db } from "@whispering233/ai-editor-db";
-import type { ProjectContext } from "../middleware/project.js";
-import { type DecomposeSession } from "./llm.js";
-import { type AliasCandidate, type DecomposeEntityKind } from "./merge.js";
-import { type ReportChapter } from "./report.js";
-/** 归并清单里关系条目的 `type`（关系表无类型列；实体条目用 `entities.type`，报告用 `DECOMPOSE_REPORT_ENTITY_TYPE`） */
-export declare const DECOMPOSE_MERGE_RELATION_TYPE = "relation";
-/** 别名后缀（§6 第 3 层：别名进 description 的「（又称：X、Y）」，不动 schema） */
-export declare const DECOMPOSE_ALIAS_NOTE_PREFIX = "\uFF08\u53C8\u79F0\uFF1A";
-export declare const DECOMPOSE_ALIAS_NOTE_SEPARATOR = "\u3001";
-/** 实体类别：关系端点**同名跨类型**时的解析优先级（先人物，再设定，末地点） */
-export declare const DECOMPOSE_ENTITY_KINDS: readonly ["character", "setting", "location"];
-/** S3 + S4 的入参：项目 / job / 本 job 的拆解会话（模型调用与过程条目都写它）/ 时间（本模块不生成时间） */
-export interface DecomposeMergeInput {
-    project: ProjectContext;
-    jobId: string;
-    session: DecomposeSession;
-    now: string;
-}
-/** 一轮 S3 + S4 的收尾统计（runner 只记日志；断言走库内数据） */
-export interface DecomposeMergeSummary {
-    entities: number;
-    relations: number;
-    aliasGroups: number;
-    reportId: string;
-}
-/** 单个实体在全书提及里的归并素材 */
-export interface MentionAggregate {
-    /** 全部提及里最长的一条 description（最完整的一条：别名归并候选的 short summary 与实体 description 共用） */
-    description: string;
-    /** 按类型收敛的其余字段（首个非空值胜出；`description` 不在其中，它由 appendAliasNote 组装） */
-    data: Record<string, unknown>;
-}
-/**
- * S3 别名归并候选（§6 第 2 层）：人物候选（第 1 层去重后）+ 出现章数 + 首次出现章 + 短摘要。
- * 短摘要 = 该人物出现章里最完整的一条 `description`（截断）——LLM 只看到这份清单，看不到原文。
- */
-export declare function buildAliasCandidates(results: readonly DecomposeBatchResult[]): AliasCandidate[];
-/** 提及素材聚合（纯函数）：`description` 取最长的一条，其余字段取首个非空值（跨章提及并成一行实体） */
-export declare function aggregateMentions(results: readonly DecomposeBatchResult[]): Map<string, MentionAggregate>;
-/** 描述 + 「（又称：X、Y）」；描述为空时只留别称（§6 第 3 层） */
-export declare function appendAliasNote(description: string, aliases: readonly string[]): string;
-/**
- * 章摘要回写大纲（§5）：**只写 `summary`**（章标题权威 = S1 写的大纲节点标题）。一次读 + 一次写
- * （逐节点调用会让 N 章 × 原子写 fsync 变成 N 次落盘，同 S1 建档的取舍）；摘要与节点现值相同则不触碰该节点。
- * @returns 实际改动的章数
- */
-export declare function writeChapterSummaries(project: ProjectContext, results: readonly DecomposeBatchResult[], now: string): number;
-/** 报告章条目（章序 = 文件位置序；标题取大纲节点、摘要取批结果、长度取正文投影） */
-export declare function reportChapters(project: ProjectContext, results: readonly DecomposeBatchResult[]): ReportChapter[];
-/**
- * S3 + S4 一轮：别名归并调用 → 四步纯管线 → 三路比对 → 落库（实体 / 关系 / 章摘要 / 报告）→ 写 `merge_written`。
- * 幂等由三路比对保证（同一份批结果跑两遍：实体/关系数量不变，报告更新同一条）；**跨轮 baseline** =
- * 历史全部 job 的 `merge_written` 并集（§6.1）⇒ 续拆时同名行复用 + 增量更新，跨轮未重现的产物不软删。
- * 调用方（runner 收口路径）负责 job 状态；本模块只写业务数据与清单。
- */
-export declare function runDecomposeMerge(input: DecomposeMergeInput): Promise<DecomposeMergeSummary>;
-/**
- * 某类型的**全部**活实体（`listEntities` 每页上限 `MAX_ENTITY_LIST_LIMIT` ⇒ 分页取全）：
- * 两个调用面都要「全库」，不得只看首页——S3 的同名复用（这里）与起始快照的 `snapshotKnownNames` 全集
- * （`runner.ts` 的 `readStartSnapshot`）；两处各写一份必然漂移，故共用本实现。
- */
-export declare function listAllLiveEntities(db: Db, type: DecomposeEntityKind): EntitySummary[];
-/**
- * 增量更新（§6 第 3 层）：把本轮实体 data 并进库内现值。**无变化时返回入参本身**（同一引用）
- * —— 调用方据此判「不写」（`updated_at` 同时是 baseline 比对依据）。
- * - `description`：剥掉「（又称：…）」段后**取更长者**（与 `entityDataOf` 的「最长的一条」同口径），
- *   别名段取**并集**（不丢上一轮别名）；
- * - 数组字段（`personality` / `tags` / `rules`）：**并集**（库内在前 ⇒ 顺序稳定，重跑幂等）；
- * - `role`：本轮**非空则覆盖**（续拆后定位可能变化）；
- * - 其余字段（`gender` / `age` / `race` / `alias` / `type` / `motivation` …）：**仅库内为空时填**。
- */
-export declare function mergeEntityData(current: Record<string, unknown>, incoming: Record<string, unknown>): Record<string, unknown>;
-//# sourceMappingURL=merge-write.d.ts.map

package/dist/decompose/merge-write.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"merge-write.d.ts","sourceRoot":"","sources":["../../src/decompose/merge-write.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,oBAAoB,EAAa,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEtG,OAAO,EAqBL,KAAK,EAAE,EAER,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAG/D,OAAO,EAAkB,KAAK,gBAAgB,EAAqB,MAAM,UAAU,CAAC;AACpF,OAAO,EAUL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAOzB,MAAM,YAAY,CAAC;AACpB,OAAO,EAQL,KAAK,aAAa,EAEnB,MAAM,aAAa,CAAC;AAErB,0FAA0F;AAC1F,eAAO,MAAM,6BAA6B,aAAa,CAAC;AACxD,2DAA2D;AAC3D,eAAO,MAAM,2BAA2B,6BAAS,CAAC;AAClD,eAAO,MAAM,8BAA8B,WAAM,CAAC;AAClD,6CAA6C;AAC7C,eAAO,MAAM,sBAAsB,+CAAyF,CAAC;AAK7H,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,gBAAgB,CAAC;IAC1B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,4CAA4C;AAC5C,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,sBAAsB;AACtB,MAAM,WAAW,gBAAgB;IAC/B,8EAA8E;IAC9E,WAAW,EAAE,MAAM,CAAC;IACpB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,GAAG,cAAc,EAAE,CAU/F;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,SAAS,oBAAoB,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAuBzG;AAED,0CAA0C;AAC1C,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAIvF;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,SAAS,oBAAoB,EAAE,EACxC,GAAG,EAAE,MAAM,GACV,MAAM,CAkBR;AAED,+CAA+C;AAC/C,wBAAgB,cAAc,CAAC,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,oBAAoB,EAAE,GAAG,aAAa,EAAE,CAcjH;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAmElG;AA2JD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,mBAAmB,GAAG,aAAa,EAAE,CAOtF;AAqKD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAsBzB"}