@fgbg/mdocs 0.8.25 → 1.1.0

package/dist/server/documents/graph/utils.test.js

@@ -0,0 +1,87 @@
+/**
+ * 图谱工具函数单元测试。
+ */
+import { describe, expect, test } from 'vitest';
+import { makeNodeId, needRebuild, slugify, findRootNodes } from './utils.js';
+describe('slugify', () => {
+    test('中文 label 正常保留', () => {
+        expect(slugify('恢复码')).toBe('恢复码');
+    });
+    test('英文转小写', () => {
+        expect(slugify('Recovery Code')).toBe('recovery-code');
+    });
+    test('空格替换为 -', () => {
+        expect(slugify('hello world')).toBe('hello-world');
+    });
+    test('特殊字符替换并去重', () => {
+        expect(slugify('a!@#b')).toBe('a-b');
+    });
+    test('首尾空格和 - 去掉', () => {
+        expect(slugify('  -hello-  ')).toBe('hello');
+    });
+    test('中英混合', () => {
+        expect(slugify('OAuth2 认证')).toBe('oauth2-认证');
+    });
+});
+describe('makeNodeId', () => {
+    test('doc 类型', () => {
+        const id = makeNodeId('doc', '恢复码是什么');
+        expect(id).toMatch(/^doc:恢复码是什么-\d{4}$/);
+    });
+    test('concept 类型', () => {
+        const id = makeNodeId('concept', '身份认证');
+        expect(id).toMatch(/^concept:身份认证-\d{4}$/);
+    });
+    test('每次生成的 id 不同（随机后缀）', () => {
+        const id1 = makeNodeId('doc', '测试');
+        const id2 = makeNodeId('doc', '测试');
+        expect(id1).not.toBe(id2);
+    });
+    test('label 会被 slugify', () => {
+        const id = makeNodeId('doc', 'Hello World');
+        expect(id).toMatch(/^doc:hello-world-\d{4}$/);
+    });
+});
+describe('needRebuild', () => {
+    test('无缓存时需要重建', () => {
+        expect(needRebuild('abc')).toBe(true);
+    });
+    test('commit 相同不需要重建', () => {
+        expect(needRebuild('abc', 'abc')).toBe(false);
+    });
+    test('commit 不同需要重建', () => {
+        expect(needRebuild('abc', 'def')).toBe(true);
+    });
+});
+describe('findRootNodes', () => {
+    test('没有边时所有节点都是根节点', () => {
+        const nodes = [{ id: 'a' }, { id: 'b' }, { id: 'c' }];
+        const result = findRootNodes(nodes, []);
+        expect(result.map(n => n.id)).toEqual(['a', 'b', 'c']);
+    });
+    test('单层包含：被指向的不是根节点', () => {
+        const nodes = [{ id: 'a' }, { id: 'b' }, { id: 'c' }];
+        const edges = [{ to: 'b' }, { to: 'c' }];
+        const result = findRootNodes(nodes, edges);
+        expect(result.map(n => n.id)).toEqual(['a']);
+    });
+    test('多层包含：只有最顶层是根节点', () => {
+        const nodes = [{ id: 'a' }, { id: 'b' }, { id: 'c' }];
+        const edges = [{ to: 'b' }, { to: 'c' }];
+        // a 指向 b，b 指向 c —— 这里只用 to 来算入度，所以 a、b 都是根
+        // （我们只测试 findRootNodes 函数本身，边的来源由调用方保证）
+        const result = findRootNodes(nodes, edges);
+        expect(result.map(n => n.id)).toEqual(['a']);
+    });
+    test('多根节点', () => {
+        const nodes = [{ id: 'a' }, { id: 'b' }, { id: 'c' }, { id: 'd' }];
+        const edges = [{ to: 'b' }, { to: 'd' }];
+        const result = findRootNodes(nodes, edges);
+        expect(result.map(n => n.id)).toEqual(['a', 'c']);
+    });
+    test('空节点列表返回空', () => {
+        const result = findRootNodes([], [{ to: 'y' }]);
+        expect(result).toEqual([]);
+    });
+});
+//# sourceMappingURL=utils.test.js.map

package/dist/server/documents/graph/utils.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.test.js","sourceRoot":"","sources":["../../../../src/server/documents/graph/utils.test.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE7E,QAAQ,CAAC,SAAS,EAAE,GAAG,EAAE;IACvB,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;QACjB,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;QACnB,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,WAAW,EAAE,GAAG,EAAE;QACrB,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE;QACtB,MAAM,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;QAChB,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE;QAClB,MAAM,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACvC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE;QACtB,MAAM,EAAE,GAAG,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC,CAAC;IAC7C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,mBAAmB,EAAE,GAAG,EAAE;QAC7B,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACpC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAC5B,MAAM,EAAE,GAAG,UAAU,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;QAC5C,MAAM,CAAC,EAAE,CAAC,CAAC,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,aAAa,EAAE,GAAG,EAAE;IAC3B,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE;QACpB,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC1B,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE;QACzB,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE;QACzB,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC1B,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gBAAgB,EAAE,GAAG,EAAE;QAC1B,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACzC,2CAA2C;QAC3C,wCAAwC;QACxC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;QAChB,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACnE,MAAM,KAAK,GAAG,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;QACzC,MAAM,MAAM,GAAG,aAAa,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE;QACpB,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;QAChD,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/server/documents/graph-cache-io.js

@@ -0,0 +1,254 @@
+/**
+ * 图谱隐藏文件 IO —— DB 行 + 磁盘内容的读写删除。
+ *
+ * 两层缓存（见 graph-cache-dirty / knowledge-graph 契约）：
+ * - 文章级：`{父目录}/__graph__/{documentId}.graph.json`，DB id = `{documentId}.graph-file`
+ * - 目录级：`{目录}/___graph___.json`，DB id = `{folderId}.graph-file`
+ * - 域级：域根 `___graph___.json`，DB id = `{domainId}.graph-file`
+ *
+ * 落盘形状为完整 `GraphFile`（version + meta + nodes + edges）；
+ * 读路径经 `parseArticleGraphFile` / `parseDirGraphFile` 兼容旧格式。
+ *
+ * 调用方：
+ * - `graph.service` 的 GraphDeps 适配
+ * - `graph/lifecycle` 的 dirty 标记与删缓存
+ *
+ * 本模块不跑 AI、不改正文文档。
+ */
+import { createHash } from "node:crypto";
+import { getDb } from "../db/connection.js";
+import { deleteDocument, findDocumentById, findDocumentByPath, insertDocument, updateDocumentContent, } from "../db/repositories/document.repo.js";
+import { findDomainById } from "../db/repositories/domain.repo.js";
+import { deleteDocumentFile, readDocument, writeDocument } from "../storage/file-store.js";
+import { ARTICLE_GRAPH_DIRNAME, DIR_GRAPH_FILENAME, GRAPH_FILE_TYPE, articleGraphFileName, } from "../../shared/graph-files.js";
+import { FILE_TYPE } from "../../shared/file-types.js";
+import { graphFileToGraph, parseArticleGraphFile, parseDirGraphFile, } from "./graph/graph-file.js";
+function contentHash(str) {
+    return createHash("sha1").update(str).digest("hex");
+}
+/** 写隐藏文件时的 owner：优先正文/目录行，否则域创建者 */
+function resolveOwnerVisitorId(documentId, domainId) {
+    const db = getDb();
+    const doc = findDocumentById(db, documentId);
+    if (doc)
+        return doc.owner_visitor_id;
+    const domain = findDomainById(db, domainId);
+    return domain?.creator_visitor_id ?? "system";
+}
+/** 读文章级图谱缓存；不存在或解析失败返回 null */
+export function readArticleGraphFile(documentId) {
+    const db = getDb();
+    const graphFile = findDocumentById(db, `${documentId}.graph-file`);
+    if (!graphFile)
+        return null;
+    try {
+        const { content } = readDocument(graphFile.domain_id, graphFile.relative_path);
+        return parseArticleGraphFile(JSON.parse(content));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 写文章级图谱缓存。
+ * 正文须有 parent_id（落在某目录下）；会按需创建 `__graph__/`。
+ * 无父目录（域根文章）时静默跳过。
+ */
+export function writeArticleGraphFile(documentId, file) {
+    const db = getDb();
+    const doc = findDocumentById(db, documentId);
+    if (!doc || !doc.parent_id)
+        return;
+    const ownerVisitorId = doc.owner_visitor_id;
+    const domainId = doc.domain_id;
+    const graphDir = ensureGraphDir(db, doc.parent_id, domainId, ownerVisitorId);
+    const fileName = articleGraphFileName(documentId);
+    const filePath = `${graphDir.relative_path}/${fileName}`;
+    const content = JSON.stringify(file, null, 2);
+    upsertGraphFileContent({
+        documentId: `${documentId}.graph-file`,
+        domainId,
+        relativePath: filePath,
+        displayName: fileName,
+        parentId: graphDir.document_id,
+        content,
+        ownerVisitorId,
+    });
+}
+/** 删除文章级缓存（DB 行 + 磁盘）；不存在则 noop */
+export function deleteArticleGraphCache(documentId) {
+    const db = getDb();
+    const graphFile = findDocumentById(db, `${documentId}.graph-file`);
+    if (!graphFile)
+        return;
+    try {
+        deleteDocumentFile(graphFile.domain_id, graphFile.relative_path);
+    }
+    catch {
+        // 盘上可能已不存在
+    }
+    deleteDocument(db, graphFile.document_id);
+}
+/** 读目录级 `___graph___.json`；不存在或解析失败返回 null */
+export function readDirGraphFile(folderId) {
+    const db = getDb();
+    const graphFile = findDocumentById(db, `${folderId}.graph-file`);
+    if (!graphFile)
+        return null;
+    try {
+        const { content } = readDocument(graphFile.domain_id, graphFile.relative_path);
+        return parseDirGraphFile(JSON.parse(content));
+    }
+    catch {
+        return null;
+    }
+}
+/** 写目录级图谱（含 meta.dirty）；目录行须存在 */
+export function writeDirGraphFile(folderId, file) {
+    const db = getDb();
+    const folder = findDocumentById(db, folderId);
+    if (!folder)
+        return;
+    const filePath = `${folder.relative_path}/${DIR_GRAPH_FILENAME}`;
+    const content = JSON.stringify(file, null, 2);
+    upsertGraphFileContent({
+        documentId: `${folderId}.graph-file`,
+        domainId: folder.domain_id,
+        relativePath: filePath,
+        displayName: DIR_GRAPH_FILENAME,
+        parentId: folderId,
+        content,
+        ownerVisitorId: folder.owner_visitor_id,
+    });
+}
+/** 读域级图谱；不存在或解析失败返回 null */
+export function readDomainGraphFile(domainId) {
+    const db = getDb();
+    const graphFile = findDocumentById(db, `${domainId}.graph-file`);
+    if (!graphFile)
+        return null;
+    try {
+        const { content } = readDocument(domainId, graphFile.relative_path);
+        return parseDirGraphFile(JSON.parse(content));
+    }
+    catch {
+        return null;
+    }
+}
+/** 写域级图谱到域根 `___graph___.json`（parent_id = null） */
+export function writeDomainGraphFile(domainId, file) {
+    const db = getDb();
+    const filePath = DIR_GRAPH_FILENAME;
+    const content = JSON.stringify(file, null, 2);
+    const ownerVisitorId = resolveOwnerVisitorId(domainId, domainId);
+    const existing = findDocumentById(db, `${domainId}.graph-file`);
+    if (existing) {
+        updateDocumentContent(db, {
+            documentId: existing.document_id,
+            displayName: DIR_GRAPH_FILENAME,
+            contentHash: contentHash(content),
+            updatedBy: ownerVisitorId,
+            updatedAt: new Date().toISOString(),
+        });
+    }
+    else {
+        insertDocument(db, {
+            documentId: `${domainId}.graph-file`,
+            domainId,
+            relativePath: filePath,
+            displayName: DIR_GRAPH_FILENAME,
+            ownerVisitorId,
+            createdBy: ownerVisitorId,
+            updatedBy: ownerVisitorId,
+            contentHash: contentHash(content),
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            permission: 1,
+            fileType: FILE_TYPE.GRAPH_FILE,
+            parentId: null,
+        });
+    }
+    writeDocument(domainId, filePath, content);
+}
+/** GET API：只返回 nodes+edges，剥掉 meta */
+export function getDirGraphPayload(folderId) {
+    const file = readDirGraphFile(folderId);
+    return file ? graphFileToGraph(file) : null;
+}
+/** GET API：域级 nodes+edges */
+export function getDomainGraphPayload(domainId) {
+    const file = readDomainGraphFile(domainId);
+    return file ? graphFileToGraph(file) : null;
+}
+/** 按 relative_path upsert graph_file 行并写盘 */
+function upsertGraphFileContent(params) {
+    const db = getDb();
+    const existing = findDocumentByPath(db, params.domainId, params.relativePath);
+    if (existing) {
+        updateDocumentContent(db, {
+            documentId: existing.document_id,
+            displayName: params.displayName,
+            contentHash: contentHash(params.content),
+            updatedBy: params.ownerVisitorId,
+            updatedAt: new Date().toISOString(),
+        });
+    }
+    else {
+        insertDocument(db, {
+            documentId: params.documentId,
+            domainId: params.domainId,
+            relativePath: params.relativePath,
+            displayName: params.displayName,
+            ownerVisitorId: params.ownerVisitorId,
+            createdBy: params.ownerVisitorId,
+            updatedBy: params.ownerVisitorId,
+            contentHash: contentHash(params.content),
+            createdAt: new Date().toISOString(),
+            updatedAt: new Date().toISOString(),
+            permission: 1,
+            fileType: GRAPH_FILE_TYPE.FILE,
+            parentId: params.parentId,
+        });
+    }
+    writeDocument(params.domainId, params.relativePath, params.content);
+}
+/** 查找父目录下的 `__graph__` 子目录行 */
+function findGraphDir(db, parentId, domainId) {
+    const parent = findDocumentById(db, parentId);
+    if (!parent)
+        return null;
+    const graphDirPath = `${parent.relative_path}/${ARTICLE_GRAPH_DIRNAME}`;
+    return findDocumentByPath(db, domainId, graphDirPath) || null;
+}
+/**
+ * 确保 `__graph__/` 目录 DB 行存在（file_type=graph_dir）。
+ * 仅建元数据行，不在盘上单独建空目录；文章缓存写入时会带出路径。
+ */
+function ensureGraphDir(db, parentId, domainId, ownerVisitorId) {
+    const existing = findGraphDir(db, parentId, domainId);
+    if (existing)
+        return existing;
+    const parent = findDocumentById(db, parentId);
+    if (!parent)
+        throw new Error(`父目录不存在：${parentId}`);
+    const now = new Date().toISOString();
+    const dirId = `${parentId}.graph-dir`;
+    const dirPath = `${parent.relative_path}/${ARTICLE_GRAPH_DIRNAME}`;
+    insertDocument(db, {
+        documentId: dirId,
+        domainId,
+        relativePath: dirPath,
+        displayName: ARTICLE_GRAPH_DIRNAME,
+        ownerVisitorId,
+        createdBy: ownerVisitorId,
+        updatedBy: ownerVisitorId,
+        contentHash: "",
+        createdAt: now,
+        updatedAt: now,
+        permission: 1,
+        fileType: GRAPH_FILE_TYPE.DIR,
+        parentId,
+    });
+    return findDocumentById(db, dirId);
+}
+//# sourceMappingURL=graph-cache-io.js.map

package/dist/server/documents/graph-cache-io.js.map

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

package/dist/server/documents/graph-lifecycle.js

@@ -0,0 +1,19 @@
+/* ── 实现 ── */
+export function createGraphLifecycle(ctx) {
+    return {
+        taskStarted: (data) => ctx.emit('task.started', data),
+        docStarted: (data) => ctx.emit('doc.started', data),
+        docCompleted: (data) => ctx.emit('doc.completed', data),
+        docFailed: (data) => ctx.emit('doc.failed', data, 'warn'),
+        folderStarted: (data) => ctx.emit('folder.started', data),
+        folderCompleted: (data) => ctx.emit('folder.completed', data),
+        folderFailed: (data) => ctx.emit('folder.failed', data, 'warn'),
+        domainStarted: (data) => ctx.emit('domain.started', data),
+        domainCompleted: (data) => ctx.emit('domain.completed', data),
+        taskProgress: (data) => ctx.emit('task.progress', data),
+        taskCompleted: (data) => ctx.emit('task.completed', data),
+        taskFailed: (data) => ctx.emit('task.failed', data, 'error'),
+        taskYielded: (data) => ctx.emit('task.yielded', data),
+    };
+}
+//# sourceMappingURL=graph-lifecycle.js.map

package/dist/server/documents/graph-lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-lifecycle.js","sourceRoot":"","sources":["../../../src/server/documents/graph-lifecycle.ts"],"names":[],"mappings":"AA8BA,cAAc;AAEd,MAAM,UAAU,oBAAoB,CAAC,GAAgB;IACnD,OAAO;QACL,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC;QAErD,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC;QACnD,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC;QACvD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,MAAM,CAAC;QAEzD,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC;QACzD,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC;QAC7D,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM,CAAC;QAE/D,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC;QACzD,eAAe,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,kBAAkB,EAAE,IAAI,CAAC;QAE7D,YAAY,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC;QACvD,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,IAAI,CAAC;QACzD,UAAU,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,OAAO,CAAC;QAC5D,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC;KACtD,CAAC;AACJ,CAAC"}

package/dist/server/documents/graph-task.js

@@ -0,0 +1,232 @@
+/**
+ * 图谱生成任务 — 注册到任务队列。
+ *
+ * 副作用导入即可注册：import './graph-task.js'
+ *
+ * 分层：
+ * - TaskQueue 只调度；本文件的 run 才是业务
+ * - domain → runDomainGraph（按一级节点循环，内部仍走 buildGraph）
+ * - dir/doc → runDocGraph（buildGraphByDocId 胶水一层后进 buildGraph）
+ * - 进度：createBuildProgressHooks 把 onArticle/onFolderPhase 接到 lifecycle + yield
+ */
+import { taskQueue } from "../task-queue/index.js";
+import { createGraphLifecycle } from "./graph-lifecycle.js";
+import { buildGraphByDocId, createGraphDeps, buildTreeNodeForDoc, } from "./graph.service.js";
+import { buildGraph, aggregateAndInduce, countDocumentLeaves, } from "./graph/index.js";
+import { getDb } from "../db/connection.js";
+import { findDocumentById, listDocumentsByDomain } from "../db/repositories/document.repo.js";
+import { findDomainById } from "../db/repositories/domain.repo.js";
+import { FILE_TYPE } from "../../shared/file-types.js";
+/* ── 任务定义 ── */
+taskQueue.registerTask("graph-generate", {
+    // 同 type+target 去重；前端轮询也靠这个 id
+    makeId: (payload) => `graph:${payload.type}:${payload.targetId}`,
+    run: async (payload, ctx) => {
+        // lifecycle → 写任务日志；scheduler → shouldYield / yield
+        const lifecycle = createGraphLifecycle(ctx);
+        const scheduler = ctx.scheduler;
+        if (payload.type === "domain") {
+            await runDomainGraph(payload, lifecycle, scheduler);
+        }
+        else {
+            // dir 与 doc 共用：目录会在 buildGraph 里递归叶子文章
+            await runDocGraph(payload, lifecycle, scheduler);
+        }
+    },
+});
+/**
+ * 把核心 buildGraph 的进度回调接到任务生命周期。
+ * - onArticle：每篇叶子的 start/done/cached/failed
+ * - onFolderPhase：目录归纳 / 写盘
+ * - 每处理完 3 篇且 shouldYield 时 await yield，让出并发槽
+ *
+ * 进度用 counter + totalDocs，不用单棵子树内部的 e.index（域级多棵树会重置）。
+ */
+function createBuildProgressHooks(opts) {
+    const { lifecycle, scheduler, totalDocs, startedAt, counter } = opts;
+    return {
+        onArticle: async (e) => {
+            if (e.phase === "start") {
+                // 开始抽当前篇；index 用全局已完成数，方便前端显示「第几篇」
+                lifecycle.docStarted({
+                    docPath: e.docPath,
+                    docId: e.documentId,
+                    index: counter.done,
+                    total: totalDocs,
+                });
+                lifecycle.taskProgress({
+                    current: counter.done,
+                    total: totalDocs,
+                    phase: "extract",
+                });
+                return;
+            }
+            if (e.phase === "failed") {
+                lifecycle.docFailed({
+                    docPath: e.docPath,
+                    docId: e.documentId,
+                    error: e.error ?? "",
+                });
+                return;
+            }
+            // done | cached：本篇结束，计数 +1
+            counter.done += 1;
+            lifecycle.docCompleted({
+                docPath: e.docPath,
+                docId: e.documentId,
+                conceptsExtracted: e.nodesExtracted ?? 0,
+                durationMs: e.durationMs ?? 0,
+            });
+            lifecycle.taskProgress({
+                current: counter.done,
+                total: totalDocs,
+                phase: e.phase === "cached" ? "cached" : "extract",
+            });
+            // 协作式让出：有人排队且时间片到了才挂起
+            if (counter.done % 3 === 0 && scheduler.shouldYield()) {
+                lifecycle.taskYielded({
+                    current: counter.done,
+                    total: totalDocs,
+                    reason: "time-slice",
+                });
+                await scheduler.yield();
+            }
+        },
+        onFolderPhase: (e) => {
+            if (e.phase === "induce") {
+                // 子树文章都处理完，开始对本目录做 concept / contains 归纳
+                lifecycle.folderStarted({
+                    folderPath: e.folderPath,
+                    folderId: e.folderId,
+                    docCount: totalDocs,
+                });
+                lifecycle.taskProgress({
+                    current: counter.done,
+                    total: totalDocs,
+                    phase: "induction",
+                });
+            }
+            else if (e.phase === "write") {
+                lifecycle.folderCompleted({
+                    folderPath: e.folderPath,
+                    folderId: e.folderId,
+                    durationMs: Date.now() - startedAt,
+                });
+            }
+        },
+    };
+}
+/* ── Domain 级生成 ── */
+/**
+ * 域级：对每个一级节点 buildGraph，再 aggregateAndInduce，写入域根图谱。
+ * 已有 rootNode + deps，直接调核心 buildGraph（不必再走 buildGraphByDocId）。
+ */
+async function runDomainGraph(payload, lifecycle, scheduler) {
+    const startTime = Date.now();
+    const db = getDb();
+    const domain = findDomainById(db, payload.targetId);
+    if (!domain) {
+        throw new Error(`域不存在：${payload.targetId}`);
+    }
+    // 域下 parent_id 为空的一级节点（排除图谱隐藏文件）
+    const allDocs = listDocumentsByDomain(db, payload.targetId);
+    const topLevelDocs = allDocs.filter((d) => !d.parent_id &&
+        d.file_type !== FILE_TYPE.GRAPH_FILE &&
+        d.file_type !== FILE_TYPE.GRAPH_DIR);
+    // 先拼树，再数全域叶子文章 → 进度 total
+    const rootNodes = topLevelDocs.map((d) => buildTreeNodeForDoc(d));
+    const totalDocs = Math.max(1, rootNodes.reduce((sum, n) => sum + countDocumentLeaves(n), 0));
+    lifecycle.taskStarted({
+        targetType: "domain",
+        targetId: payload.targetId,
+        totalDocs,
+    });
+    lifecycle.domainStarted({ domainId: payload.targetId, folderCount: topLevelDocs.length });
+    const deps = createGraphDeps(payload.agentConfig, payload.targetId, domain.creator_visitor_id);
+    // 同一 counter 贯穿所有一级子树，文章进度连续累加
+    const counter = { done: 0 };
+    const progress = createBuildProgressHooks({
+        lifecycle,
+        scheduler,
+        totalDocs,
+        startedAt: startTime,
+        counter,
+    });
+    const childGraphs = [];
+    for (let i = 0; i < topLevelDocs.length; i++) {
+        const doc = topLevelDocs[i];
+        const rootNode = rootNodes[i];
+        try {
+            // 一级节点可能是目录：buildGraph 内部仍会一篇篇 onArticle
+            childGraphs.push(await buildGraph(rootNode, deps, { force: payload.force, ...progress }));
+        }
+        catch (err) {
+            lifecycle.docFailed({
+                docPath: doc.relative_path,
+                docId: doc.document_id,
+                error: err.message,
+            });
+        }
+    }
+    // 域顶层再归纳一次，写 domain 级缓存
+    lifecycle.taskProgress({ current: totalDocs, total: totalDocs, phase: "induction" });
+    const result = await aggregateAndInduce(childGraphs, deps);
+    await deps.writeDomainGraph(payload.targetId, {
+        version: 1,
+        meta: { dirty: false },
+        nodes: result.nodes,
+        edges: result.edges,
+    });
+    const durationMs = Date.now() - startTime;
+    lifecycle.domainCompleted({
+        domainId: payload.targetId,
+        totalNodes: result.nodes.length,
+        totalEdges: result.edges.length,
+        durationMs,
+    });
+    lifecycle.taskCompleted({
+        totalDocs,
+        nodes: result.nodes.length,
+        edges: result.edges.length,
+        durationMs,
+    });
+}
+/* ── Doc / Dir 级生成 ── */
+/**
+ * 单篇或目录：只有 document_id，走 buildGraphByDocId（查库拼树 + 造 deps + buildGraph）。
+ */
+async function runDocGraph(payload, lifecycle, scheduler) {
+    const startTime = Date.now();
+    const db = getDb();
+    const doc = findDocumentById(db, payload.targetId);
+    if (!doc) {
+        throw new Error(`文档不存在：${payload.targetId}`);
+    }
+    // 仅用于算 totalDocs；真正构建仍由 buildGraphByDocId 内部再拼一次树
+    const rootNode = buildTreeNodeForDoc(doc, payload.visitorId);
+    const totalDocs = Math.max(1, countDocumentLeaves(rootNode));
+    lifecycle.taskStarted({
+        targetType: payload.type,
+        targetId: payload.targetId,
+        totalDocs,
+    });
+    const counter = { done: 0 };
+    const progress = createBuildProgressHooks({
+        lifecycle,
+        scheduler,
+        totalDocs,
+        startedAt: startTime,
+        counter,
+    });
+    // 胶水入口：id → TreeNode + GraphDeps → buildGraph(options 含 progress)
+    const graph = await buildGraphByDocId(payload.targetId, payload.agentConfig, payload.visitorId, { force: payload.force, ...progress });
+    const durationMs = Date.now() - startTime;
+    lifecycle.taskProgress({ current: totalDocs, total: totalDocs, phase: "complete" });
+    lifecycle.taskCompleted({
+        totalDocs,
+        nodes: graph.nodes.length,
+        edges: graph.edges.length,
+        durationMs,
+    });
+}
+//# sourceMappingURL=graph-task.js.map

package/dist/server/documents/graph-task.js.map

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