@jingyi0605/codingns 0.8.5 → 0.9.5

package/dist/server/modules/workspace/affairs-tag-service.js

@@ -0,0 +1,719 @@
+import fs from "node:fs";
+import path from "node:path";
+import { AppError } from "../../shared/errors/app-error.js";
+import { HOST_TASK_TYPES } from "../tasks/task-types.js";
+import { AFFAIRS_GLOBAL_WORKSPACE_ID } from "./affairs-library-service.js";
+import { CatalogRepository, } from "../affairs-indexer/core/src/repositories/catalog-repository.js";
+import { CatalogWriteRepository, } from "../affairs-indexer/core/src/repositories/catalog-write-repository.js";
+import { createAffairsIndexerRuntimeConfig } from "../affairs-indexer/internal-command-runner.js";
+import { TagRecomputeService } from "../affairs-indexer/core/src/services/tagging/tag-recompute-service.js";
+import { ExportBuilder } from "../affairs-indexer/core/src/services/export/export-builder.js";
+import { initCatalog } from "../affairs-indexer/core/src/sqlite/init-catalog.js";
+const TAG_EXPORT_REFRESH_TASK_TIMEOUT_MS = 30 * 60 * 1000;
+const TAG_RECOMPUTE_TASK_TIMEOUT_MS = 30 * 60 * 1000;
+export class AffairsTagService {
+    workspaceService;
+    affairsLibraryService;
+    taskManager;
+    teableMirrorSyncNotifier = null;
+    constructor(workspaceService, affairsLibraryService, taskManager) {
+        this.workspaceService = workspaceService;
+        this.affairsLibraryService = affairsLibraryService;
+        this.taskManager = taskManager;
+        this.registerBackgroundTasks();
+    }
+    configureTeableMirrorSyncNotifier(notifier) {
+        this.teableMirrorSyncNotifier = notifier;
+    }
+    listTags(workspaceId, userId, input = {}) {
+        const { dbPath } = this.requireBinding(workspaceId, userId);
+        return this.listTagsFromCatalog(dbPath, input);
+    }
+    listGlobalTags(userId, input = {}) {
+        const { dbPath } = this.requireGlobalBinding(userId);
+        return this.listTagsFromCatalog(dbPath, input);
+    }
+    listTagsFromCatalog(dbPath, input = {}) {
+        const repository = new CatalogRepository(dbPath);
+        const definitions = repository.listTagDefinitions(input.includeDisabled === true);
+        const enabledRules = repository.listAllEnabledTagRules();
+        const countByPath = this.buildTagDocumentCountMap(repository);
+        const resolvedRows = repository.listExportDocuments().flatMap(doc => [
+            ...doc.tags.map(tagPath => ({ tagPath, derived: false })),
+            ...doc.derivedTags.map(tagPath => ({ tagPath, derived: true })),
+        ]);
+        const parentPathById = new Map(definitions.map(item => [item.id, item.path]));
+        const items = definitions.map((tag) => this.toTagNodeDto(tag, parentPathById, countByPath.get(tag.path) ?? 0));
+        return {
+            items,
+            summary: {
+                totalActiveTags: items.filter(item => item.status === "active").length,
+                totalDisabledTags: items.filter(item => item.status === "disabled").length,
+                totalRuleEnabledTags: new Set(enabledRules.map(item => item.tagId)).size,
+                totalBoundDocuments: new Set(resolvedRows.map(item => item.tagPath)).size,
+            },
+            status: {
+                recomputeState: "idle",
+                lastRecomputedAt: null,
+                lastError: null,
+            },
+        };
+    }
+    getTagDetail(workspaceId, userId, tagId) {
+        const { dbPath } = this.requireBinding(workspaceId, userId);
+        const repository = new CatalogRepository(dbPath);
+        const definition = repository.getTagDefinitionById(tagId);
+        if (!definition) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "AFFAIRS_TAG_NOT_FOUND",
+                detail: "标签不存在",
+            });
+        }
+        const definitions = repository.listTagDefinitions(true);
+        const parentPathById = new Map(definitions.map(item => [item.id, item.path]));
+        const countByPath = this.buildTagDocumentCountMap(repository);
+        const rules = repository.listTagRulesByTagIds([tagId]);
+        return {
+            ...this.toTagNodeDto(definition, parentPathById, countByPath.get(definition.path) ?? 0),
+            smartRules: rules.map(mapTagRuleDto),
+            smartRuleEnabled: rules.some(rule => rule.enabled),
+        };
+    }
+    ensureTagDefinition(workspaceId, userId, input) {
+        const normalizedPath = normalizeTagPath(input.path);
+        if (!normalizedPath) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "AFFAIRS_TAG_PATH_REQUIRED",
+                detail: "标签路径不能为空",
+                field: "path",
+            });
+        }
+        const { dbPath, rootDir } = this.requireBinding(workspaceId, userId);
+        const repository = new CatalogRepository(dbPath);
+        const writer = new CatalogWriteRepository(dbPath);
+        const definitions = repository.listTagDefinitions(true);
+        const definitionByPath = new Map(definitions.map(item => [item.path, item]));
+        const segments = normalizedPath.split("/").filter(Boolean);
+        let currentPath = "";
+        let parentId = null;
+        let lastTagId = null;
+        let rootType = segments[0] ?? normalizedPath;
+        for (const segment of segments) {
+            currentPath = currentPath ? `${currentPath}/${segment}` : segment;
+            const existing = definitionByPath.get(currentPath);
+            if (existing) {
+                if (existing.status === "disabled") {
+                    writer.saveTagDefinition({
+                        id: existing.id,
+                        path: existing.path,
+                        name: existing.name,
+                        rootType: existing.rootType,
+                        parentId: existing.parentId,
+                        canonicalName: existing.canonicalName,
+                        description: existing.description,
+                        status: "active",
+                        createdBy: existing.createdBy,
+                    });
+                    definitionByPath.set(currentPath, { ...existing, status: "active", disabledAt: null });
+                }
+                parentId = existing.id;
+                lastTagId = existing.id;
+                rootType = existing.rootType;
+                continue;
+            }
+            const nextParentId = parentId;
+            const result = writer.saveTagDefinition({
+                path: currentPath,
+                name: segment,
+                rootType,
+                parentId: nextParentId,
+                canonicalName: segment,
+                description: null,
+                status: "active",
+                createdBy: userId || "user",
+            });
+            parentId = result.id;
+            lastTagId = result.id;
+            definitionByPath.set(currentPath, {
+                id: result.id,
+                path: currentPath,
+                name: segment,
+                rootType,
+                parentId: nextParentId,
+                canonicalName: segment,
+                description: null,
+                status: "active",
+                createdBy: userId || "user",
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+                disabledAt: null,
+            });
+        }
+        if (!lastTagId) {
+            throw new AppError({
+                statusCode: 500,
+                errorCode: "AFFAIRS_TAG_ENSURE_FAILED",
+                detail: "标签创建失败",
+            });
+        }
+        this.taskManager.enqueue(HOST_TASK_TYPES.affairsLibraryTagExportRefresh, {
+            key: `${workspaceId}:full`,
+            source: "affairs_tag.ensure_tag_definition",
+            input: {
+                workspaceId,
+                rootDir,
+                reason: `tag_definition_ensured:${lastTagId}`,
+            },
+        });
+        this.notifyTeableTagChanged(userId, `tag_definition_ensured:${lastTagId}`);
+        return this.getTagDetail(workspaceId, userId, lastTagId);
+    }
+    saveTagDefinition(workspaceId, userId, input) {
+        const { dbPath, rootDir } = this.requireBinding(workspaceId, userId);
+        const repository = new CatalogRepository(dbPath);
+        const writer = new CatalogWriteRepository(dbPath);
+        const existingDefinitions = repository.listTagDefinitions(true);
+        const current = input.tagId
+            ? existingDefinitions.find(item => item.id === input.tagId) ?? null
+            : null;
+        const parent = input.parentId ? existingDefinitions.find(item => item.id === input.parentId) ?? null : null;
+        if (input.parentId && !parent) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "AFFAIRS_TAG_PARENT_NOT_FOUND",
+                detail: "父标签不存在",
+                field: "parentId",
+            });
+        }
+        if (current && parent && isDescendantTag(existingDefinitions, parent.id, current.id)) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "AFFAIRS_TAG_PARENT_CYCLE",
+                detail: "不能把标签移动到自己的下级标签下面",
+                field: "parentId",
+            });
+        }
+        const normalizedName = input.name.trim();
+        if (!normalizedName) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "AFFAIRS_TAG_NAME_REQUIRED",
+                detail: "标签名称不能为空",
+                field: "name",
+            });
+        }
+        const nextPath = [parent?.path, normalizedName].filter(Boolean).join("/") || normalizedName;
+        const conflict = existingDefinitions.find(item => item.path === nextPath && item.id !== input.tagId);
+        if (conflict) {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "AFFAIRS_TAG_PATH_CONFLICT",
+                detail: "标签路径已存在，请换一个名称或层级",
+                field: "name",
+            });
+        }
+        const rootType = parent?.rootType ?? normalizedName;
+        if (current) {
+            const descendantUpdates = buildDescendantTagPathUpdates(existingDefinitions, current, nextPath, rootType);
+            const conflictPaths = new Set([nextPath, ...descendantUpdates.map(item => item.nextPath)]);
+            const conflict = existingDefinitions.find(item => item.id !== current.id
+                && !descendantUpdates.some(update => update.tag.id === item.id)
+                && conflictPaths.has(item.path));
+            if (conflict) {
+                throw new AppError({
+                    statusCode: 409,
+                    errorCode: "AFFAIRS_TAG_PATH_CONFLICT",
+                    detail: "标签移动后会和现有标签路径冲突",
+                    field: "parentId",
+                });
+            }
+        }
+        const result = writer.saveTagDefinition({
+            id: input.tagId,
+            path: nextPath,
+            name: normalizedName,
+            rootType,
+            parentId: parent?.id ?? null,
+            canonicalName: normalizedName,
+            description: input.description ?? null,
+            status: input.status ?? "active",
+            createdBy: userId || "user",
+        });
+        if (Array.isArray(input.smartRules)) {
+            writer.replaceTagRules(result.id, normalizeTagRulesInput(input.smartRules));
+        }
+        if (current) {
+            buildDescendantTagPathUpdates(existingDefinitions, current, nextPath, rootType)
+                .forEach(({ tag, nextPath: childPath }) => {
+                writer.saveTagDefinition({
+                    id: tag.id,
+                    path: childPath,
+                    name: tag.name,
+                    rootType,
+                    parentId: tag.parentId,
+                    canonicalName: tag.canonicalName,
+                    description: tag.description,
+                    status: tag.status === "disabled" ? "disabled" : "active",
+                    createdBy: tag.createdBy,
+                });
+            });
+        }
+        const detail = this.getTagDetail(workspaceId, userId, result.id);
+        if (Array.isArray(input.smartRules)) {
+            this.taskManager.enqueue(HOST_TASK_TYPES.affairsLibraryTagApplyBindings, {
+                key: `${workspaceId}:full`,
+                source: "affairs_tag.save_tag_definition",
+                input: {
+                    workspaceId,
+                    rootDir,
+                    reason: `tag_definition_saved:${result.id}`,
+                    scope: { kind: "full" },
+                },
+            });
+        }
+        else {
+            this.taskManager.enqueue(HOST_TASK_TYPES.affairsLibraryTagExportRefresh, {
+                key: `${workspaceId}:full`,
+                source: "affairs_tag.save_tag_definition",
+                input: {
+                    workspaceId,
+                    rootDir,
+                    reason: `tag_definition_saved:${result.id}`,
+                },
+            });
+        }
+        this.notifyTeableTagChanged(userId, `tag_definition_saved:${result.id}`);
+        return detail;
+    }
+    deleteTagDefinition(workspaceId, userId, tagId) {
+        const { dbPath, rootDir } = this.requireBinding(workspaceId, userId);
+        const repository = new CatalogRepository(dbPath);
+        const writer = new CatalogWriteRepository(dbPath);
+        const definitions = repository.listTagDefinitions(true);
+        const current = definitions.find(item => item.id === tagId) ?? null;
+        if (!current) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "AFFAIRS_TAG_NOT_FOUND",
+                detail: "标签不存在",
+            });
+        }
+        const descendants = collectDescendantTags(definitions, current.id);
+        const deleteRows = [current, ...descendants];
+        const deletedTagIds = deleteRows.map(item => item.id);
+        const deletedPaths = deleteRows.map(item => item.path);
+        writer.deleteTagDefinitions([...descendants].reverse().map(item => item.id).concat(current.id));
+        const handle = this.taskManager.enqueue(HOST_TASK_TYPES.affairsLibraryTagExportRefresh, {
+            key: `${workspaceId}:full`,
+            source: "affairs_tag.delete_tag_definition",
+            input: {
+                workspaceId,
+                rootDir,
+                reason: `tag_definition_deleted:${tagId}`,
+            },
+        });
+        this.notifyTeableTagChanged(userId, `tag_definition_deleted:${tagId}`);
+        return {
+            deletedTagIds,
+            deletedPaths,
+            exportRefreshTask: {
+                taskId: handle.taskId,
+                deduped: handle.deduped,
+                status: "queued",
+            },
+        };
+    }
+    getDocumentTagDetails(workspaceId, userId, documentId) {
+        const { dbPath } = this.requireBinding(workspaceId, userId);
+        const repository = new CatalogRepository(dbPath);
+        const context = repository.getDocumentContext(documentId);
+        if (!context) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "AFFAIRS_DOCUMENT_NOT_FOUND",
+                detail: "文档不存在",
+            });
+        }
+        const manualBindings = repository.listManualDocumentTagBindingsByDocumentIds([documentId]);
+        const folderBindings = repository.listEffectiveFolderTagBindingsForDocumentPaths([context.path]);
+        const resolved = repository.listResolvedDocumentTagsByDocumentIds([documentId]);
+        return {
+            documentId,
+            path: context.path,
+            title: context.title,
+            manualTagIds: manualBindings.map(item => item.tagId),
+            effectiveFolderBindings: folderBindings.map(item => ({
+                id: item.id,
+                folderPath: item.folderPath,
+                tagId: item.tagId,
+                tagPath: item.tagPath,
+            })),
+            resolvedTags: resolved.map(item => ({
+                path: item.path,
+                sourceType: item.sourceType,
+                sourceRef: item.sourceRef,
+                evidence: item.evidence,
+                confidence: item.confidence,
+                priority: resolvePriority(item.sourceType),
+            })),
+        };
+    }
+    saveDocumentTagBindings(workspaceId, userId, documentId, tagIds) {
+        const { dbPath, rootDir } = this.requireBinding(workspaceId, userId);
+        const repository = new CatalogRepository(dbPath);
+        const context = repository.getDocumentContext(documentId);
+        if (!context) {
+            throw new AppError({
+                statusCode: 404,
+                errorCode: "AFFAIRS_DOCUMENT_NOT_FOUND",
+                detail: "文档不存在",
+            });
+        }
+        const writer = new CatalogWriteRepository(dbPath);
+        writer.replaceManualDocumentTagBindings({
+            documentId,
+            inodeKey: context.inodeKey,
+            contentHash: context.contentHash,
+            size: context.size,
+            extension: context.extension,
+        }, tagIds);
+        const handle = this.taskManager.enqueue(HOST_TASK_TYPES.affairsLibraryTagApplyBindings, {
+            key: `${workspaceId}:doc:${documentId}`,
+            source: "affairs_tag.save_document_bindings",
+            input: {
+                workspaceId,
+                rootDir,
+                reason: `manual_document_binding_saved:${documentId}`,
+                scope: { kind: "document", documentId },
+            },
+        });
+        this.notifyTeableTagChanged(userId, `manual_document_binding_saved:${documentId}`);
+        return {
+            target: {
+                type: "document",
+                documentId,
+            },
+            items: this.getDocumentTagDetails(workspaceId, userId, documentId).resolvedTags,
+            refreshTask: {
+                taskId: handle.taskId,
+                deduped: handle.deduped,
+                affectedPaths: [context.path],
+            },
+        };
+    }
+    getFolderTagDetails(workspaceId, userId, folderPath) {
+        const { dbPath, rootDir } = this.requireBinding(workspaceId, userId);
+        const normalizedFolderPath = normalizeFolderPath(folderPath);
+        const exists = normalizedFolderPath === "."
+            ? fs.existsSync(rootDir) && fs.statSync(rootDir).isDirectory()
+            : this.affairsLibraryService.resolvePreviewFile(workspaceId, userId, normalizedFolderPath, {
+                mustExist: false,
+                kind: "directory",
+            }).exists;
+        const repository = new CatalogRepository(dbPath);
+        const bindings = repository.listFolderTagBindingsByPaths([normalizedFolderPath]);
+        return {
+            folderPath: normalizedFolderPath,
+            exists,
+            bindingTagIds: bindings.map(item => item.tagId),
+            bindings: bindings.map(item => ({
+                id: item.id,
+                tagId: item.tagId,
+                tagPath: item.tagPath,
+                applyMode: item.applyMode,
+            })),
+        };
+    }
+    getFolderTagApplyTaskSnapshot(workspaceId, userId, folderPath) {
+        this.requireBinding(workspaceId, userId);
+        const normalizedFolderPath = normalizeFolderPath(folderPath);
+        return this.taskManager.peek(HOST_TASK_TYPES.affairsLibraryTagApplyBindings, `${workspaceId}:folder:${normalizedFolderPath}`);
+    }
+    getDocumentTagApplyTaskSnapshot(workspaceId, userId, documentId) {
+        this.requireBinding(workspaceId, userId);
+        return this.taskManager.peek(HOST_TASK_TYPES.affairsLibraryTagApplyBindings, `${workspaceId}:doc:${documentId}`);
+    }
+    getFullTagRecomputeTaskSnapshot(workspaceId, userId) {
+        this.requireBinding(workspaceId, userId);
+        return this.taskManager.peek(HOST_TASK_TYPES.affairsLibraryTagRecompute, `${workspaceId}:full`);
+    }
+    getTagRecoveryStatus(workspaceId, userId) {
+        const { dbPath } = this.requireBinding(workspaceId, userId);
+        const repository = new CatalogRepository(dbPath);
+        return {
+            task: this.taskManager.peek(HOST_TASK_TYPES.affairsLibraryTagRecompute, `${workspaceId}:full`),
+            bindingStats: repository.getManualTagBindingStats(),
+        };
+    }
+    requestFullTagRecompute(workspaceId, userId) {
+        const { rootDir } = this.requireBinding(workspaceId, userId);
+        const handle = this.taskManager.enqueue(HOST_TASK_TYPES.affairsLibraryTagRecompute, {
+            key: `${workspaceId}:full`,
+            source: "affairs_tag.request_full_recompute",
+            input: {
+                workspaceId,
+                rootDir,
+                reason: "manual_full_recompute_requested",
+                scope: { kind: "full", mode: "full" },
+            },
+        });
+        return {
+            taskId: handle.taskId,
+            deduped: handle.deduped,
+            status: "queued",
+            scope: "full",
+        };
+    }
+    notifyTeableTagChanged(userId, reason) {
+        this.teableMirrorSyncNotifier?.(userId, reason);
+    }
+    saveFolderTagBindings(workspaceId, userId, folderPath, tagIds) {
+        const { dbPath, rootDir } = this.requireBinding(workspaceId, userId);
+        const normalizedFolderPath = normalizeFolderPath(folderPath);
+        const writer = new CatalogWriteRepository(dbPath);
+        writer.replaceFolderTagBindings(normalizedFolderPath, tagIds);
+        const handle = this.taskManager.enqueue(HOST_TASK_TYPES.affairsLibraryTagApplyBindings, {
+            key: `${workspaceId}:folder:${normalizedFolderPath}`,
+            source: "affairs_tag.save_folder_bindings",
+            input: {
+                workspaceId,
+                rootDir,
+                reason: `folder_binding_saved:${normalizedFolderPath}`,
+                // 文件夹分配标签只重跑目标文件夹子树，但要走完整标签推理，
+                // 这样它和“位于某文件夹及其子文件夹”的智能规则语义保持一致。
+                scope: { kind: "folder", folderPath: normalizedFolderPath },
+            },
+        });
+        this.notifyTeableTagChanged(userId, `folder_binding_saved:${normalizedFolderPath}`);
+        return {
+            target: {
+                type: "folder",
+                folderPath: normalizedFolderPath,
+            },
+            items: [],
+            refreshTask: {
+                taskId: handle.taskId,
+                deduped: handle.deduped,
+                affectedPaths: [normalizedFolderPath],
+            },
+        };
+    }
+    requireBinding(workspaceId, userId) {
+        const normalizedWorkspaceId = workspaceId.trim();
+        if (normalizedWorkspaceId !== AFFAIRS_GLOBAL_WORKSPACE_ID) {
+            this.workspaceService.getWorkspaceOrThrow(normalizedWorkspaceId);
+        }
+        const binding = this.affairsLibraryService.getBinding(normalizedWorkspaceId || AFFAIRS_GLOBAL_WORKSPACE_ID, userId);
+        const rootDir = binding?.rootDir?.trim() ?? "";
+        if (!rootDir || binding?.enabled !== true) {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "AFFAIRS_LIBRARY_BINDING_REQUIRED",
+                detail: "当前工作区还没有启用事务文档库",
+            });
+        }
+        // 这里不能假设 catalog.db 一定已经被 helper 跑到最新版本。
+        // 事务文档库标签接口会直接打开 SQLite；如果用户库还是旧 schema，
+        // prepareStatements 阶段就会因为缺表直接炸掉。
+        // 所以每次进入标签链路前先补一次幂等迁移，保证旧库也能安全读写。
+        initCatalog(createAffairsIndexerRuntimeConfig(rootDir));
+        return {
+            rootDir,
+            dbPath: resolveCatalogDbPath(rootDir),
+        };
+    }
+    requireGlobalBinding(userId) {
+        const binding = this.affairsLibraryService.getGlobalBinding(userId);
+        const rootDir = binding?.rootDir?.trim() ?? "";
+        if (!rootDir || binding?.enabled !== true) {
+            throw new AppError({
+                statusCode: 409,
+                errorCode: "AFFAIRS_LIBRARY_BINDING_REQUIRED",
+                detail: "事务文档库还没有启用",
+            });
+        }
+        initCatalog(createAffairsIndexerRuntimeConfig(rootDir));
+        return {
+            rootDir,
+            dbPath: resolveCatalogDbPath(rootDir),
+        };
+    }
+    registerBackgroundTasks() {
+        if (!this.taskManager.has(HOST_TASK_TYPES.affairsLibraryTagRecompute)) {
+            this.taskManager.register({
+                taskType: HOST_TASK_TYPES.affairsLibraryTagRecompute,
+                executionLane: "helper_process",
+                // 事务文档库全量标签恢复可能要扫几千到上万文档，30s 很容易误杀。
+                timeoutMs: TAG_RECOMPUTE_TASK_TIMEOUT_MS,
+                run: async (input, context) => {
+                    await new TagRecomputeService(createAffairsIndexerRuntimeConfig(input.rootDir)).run({
+                        scope: input.scope,
+                        signal: context.signal,
+                        onProgress: context.reportProgress,
+                    });
+                    return { ok: true };
+                },
+            });
+        }
+        if (!this.taskManager.has(HOST_TASK_TYPES.affairsLibraryTagApplyBindings)) {
+            this.taskManager.register({
+                taskType: HOST_TASK_TYPES.affairsLibraryTagApplyBindings,
+                executionLane: "helper_process",
+                timeoutMs: TAG_RECOMPUTE_TASK_TIMEOUT_MS,
+                run: async (input, context) => {
+                    await new TagRecomputeService(createAffairsIndexerRuntimeConfig(input.rootDir)).run({
+                        scope: input.scope,
+                        signal: context.signal,
+                        onProgress: context.reportProgress,
+                    });
+                    return { ok: true };
+                },
+            });
+        }
+        if (!this.taskManager.has(HOST_TASK_TYPES.affairsLibraryTagExportRefresh)) {
+            this.taskManager.register({
+                taskType: HOST_TASK_TYPES.affairsLibraryTagExportRefresh,
+                executionLane: "helper_process",
+                helperProcessHandler: "affairs.library_export",
+                // 这里跑的不是轻量标签刷新，而是整套静态导出。
+                // 大库下 20s 很容易误判超时，直接对齐文档库索引任务的分钟级超时。
+                timeoutMs: TAG_EXPORT_REFRESH_TASK_TIMEOUT_MS,
+                run: async (input, context) => {
+                    await new ExportBuilder(createAffairsIndexerRuntimeConfig(input.rootDir)).build({
+                        signal: context.signal,
+                    });
+                    return { ok: true };
+                },
+            });
+        }
+    }
+    toTagNodeDto(row, parentPathById, documentCount) {
+        return {
+            id: row.id,
+            path: row.path,
+            name: row.name,
+            rootType: row.rootType,
+            parentId: row.parentId,
+            parentPath: row.parentId ? parentPathById.get(row.parentId) ?? null : null,
+            description: row.description,
+            status: row.status === "disabled" ? "disabled" : "active",
+            documentCount,
+            createdAt: row.createdAt,
+            updatedAt: row.updatedAt,
+            disabledAt: row.disabledAt,
+        };
+    }
+    buildTagDocumentCountMap(repository) {
+        const countByPath = new Map();
+        repository.listExportDocuments().forEach((document) => {
+            document.tags.forEach((tagPath) => {
+                countByPath.set(tagPath, (countByPath.get(tagPath) ?? 0) + 1);
+            });
+            document.derivedTags.forEach((tagPath) => {
+                countByPath.set(tagPath, (countByPath.get(tagPath) ?? 0) + 1);
+            });
+        });
+        return countByPath;
+    }
+}
+function isDescendantTag(definitions, candidateId, ancestorId) {
+    let current = definitions.find(item => item.id === candidateId) ?? null;
+    const visited = new Set();
+    while (current?.parentId) {
+        if (current.parentId === ancestorId) {
+            return true;
+        }
+        if (visited.has(current.parentId)) {
+            return false;
+        }
+        visited.add(current.parentId);
+        current = definitions.find(item => item.id === current?.parentId) ?? null;
+    }
+    return false;
+}
+function collectDescendantTags(definitions, ancestorId) {
+    const childrenByParentId = new Map();
+    definitions.forEach((item) => {
+        if (!item.parentId) {
+            return;
+        }
+        const items = childrenByParentId.get(item.parentId) ?? [];
+        items.push(item);
+        childrenByParentId.set(item.parentId, items);
+    });
+    const result = [];
+    const queue = [...(childrenByParentId.get(ancestorId) ?? [])];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        result.push(current);
+        const children = childrenByParentId.get(current.id);
+        if (children?.length) {
+            queue.push(...children);
+        }
+    }
+    return result;
+}
+function buildDescendantTagPathUpdates(definitions, current, nextPath, nextRootType) {
+    const oldPrefix = `${current.path}/`;
+    const nextPrefix = `${nextPath}/`;
+    return definitions
+        .filter(item => item.path.startsWith(oldPrefix))
+        .sort((left, right) => left.path.localeCompare(right.path, "zh-Hans-CN"))
+        .map(tag => ({
+        tag,
+        nextPath: `${nextPrefix}${tag.path.slice(oldPrefix.length)}`,
+        nextRootType,
+    }));
+}
+function normalizeFolderPath(value) {
+    return value.trim().replace(/^\.\/+/, "").replace(/\/+$/g, "") || ".";
+}
+function normalizeTagPath(value) {
+    return value
+        .trim()
+        .replace(/^\/+/, "")
+        .replace(/\/+$/g, "")
+        .split("/")
+        .map(item => item.trim())
+        .filter(Boolean)
+        .join("/");
+}
+function resolveCatalogDbPath(rootDir) {
+    return path.join(rootDir, ".ai-index", "catalog.db");
+}
+function resolvePriority(sourceType) {
+    switch (sourceType) {
+        case "manual_document":
+            return 1;
+        case "folder_binding":
+            return 2;
+        case "smart_rule":
+            return 3;
+        case "system_derived":
+            return 4;
+    }
+}
+function mapTagRuleDto(rule) {
+    return {
+        id: rule.id,
+        relation: rule.relation,
+        ruleType: rule.ruleType,
+        matcher: rule.matcher,
+        enabled: rule.enabled,
+        priority: rule.priority,
+    };
+}
+function normalizeTagRulesInput(rules) {
+    return rules
+        .map((rule, index) => ({
+        relation: (rule.relation === "or" || rule.relation === "not" ? rule.relation : "and"),
+        ruleType: rule.ruleType,
+        matcher: rule.matcher,
+        enabled: rule.enabled !== false,
+        priority: Number.isFinite(rule.priority) ? rule.priority : index,
+    }))
+        .sort((left, right) => left.priority - right.priority);
+}
+//# sourceMappingURL=affairs-tag-service.js.map