@jingyi0605/codingns 0.8.1 → 0.9.0

package/dist/server/modules/affairs-indexer/core/src/repositories/catalog-write-repository.js

@@ -0,0 +1,1350 @@
+import crypto from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { openDatabase } from "../sqlite/open-database.js";
+function makeStableId(prefix, value) {
+    const digest = crypto.createHash("sha1").update(value).digest("hex");
+    return `${prefix}_${digest}`;
+}
+/**
+ * 最小写入仓库。
+ * 第二阶段补上 prepared statement 复用与批量连接内执行，减少大批量索引时的重复 prepare 与全表清理成本。
+ */
+export class CatalogWriteRepository {
+    dbPath;
+    tagIdCache = new Map();
+    activeDb = null;
+    activeStatements = null;
+    activeBootstrapSession = false;
+    constructor(dbPath) {
+        this.dbPath = dbPath;
+    }
+    beginSession() {
+        if (this.activeDb) {
+            return;
+        }
+        this.activeDb = openDatabase(this.dbPath);
+        this.activeStatements = this.prepareStatements(this.activeDb);
+        this.activeBootstrapSession = this.detectBootstrapSession(this.activeDb);
+    }
+    endSession() {
+        if (!this.activeDb) {
+            return;
+        }
+        this.activeDb.close();
+        this.activeDb = null;
+        this.activeStatements = null;
+        this.activeBootstrapSession = false;
+    }
+    withConnection(handler) {
+        if (this.activeDb && this.activeStatements) {
+            return handler(this.activeDb, this.activeStatements);
+        }
+        const db = openDatabase(this.dbPath);
+        const statements = this.prepareStatements(db);
+        try {
+            return handler(db, statements);
+        }
+        finally {
+            db.close();
+        }
+    }
+    normalizeRelativePath(relativePath) {
+        return relativePath.split(path.sep).join("/");
+    }
+    invalidateCachedTagPath(tagPath) {
+        const normalizedPath = tagPath?.trim();
+        if (!normalizedPath) {
+            return;
+        }
+        this.tagIdCache.delete(normalizedPath);
+    }
+    getSchemaMeta(key) {
+        return this.withConnection(db => {
+            const row = db.prepare(`SELECT value FROM schema_meta WHERE key = ?`).get(key);
+            return typeof row?.value === "string" ? row.value : null;
+        });
+    }
+    setSchemaMeta(key, value, updatedAt = new Date().toISOString()) {
+        this.withConnection(db => {
+            const updated = db.prepare(`
+        UPDATE schema_meta
+        SET value = ?, updated_at = ?
+        WHERE key = ?
+      `).run(value, updatedAt, key);
+            if ((updated.changes || 0) > 0) {
+                return;
+            }
+            db.prepare(`
+        INSERT INTO schema_meta(key, value, updated_at)
+        VALUES(?, ?, ?)
+      `).run(key, value, updatedAt);
+        });
+    }
+    countActiveIndexedDocuments() {
+        return this.withConnection(db => {
+            const row = db.prepare(`
+        SELECT COUNT(*) AS count
+        FROM documents d
+        JOIN files f ON f.id = d.file_id
+        WHERE f.status = 'active'
+          AND d.index_status = 'indexed'
+      `).get();
+            return Number(row?.count ?? 0);
+        });
+    }
+    countActiveFiles() {
+        return this.withConnection(db => {
+            const row = db.prepare(`
+        SELECT COUNT(*) AS count
+        FROM files
+        WHERE status = 'active'
+      `).get();
+            return Number(row?.count ?? 0);
+        });
+    }
+    countRows(tableName) {
+        return this.withConnection(db => {
+            const row = db.prepare(`SELECT COUNT(*) AS count FROM ${tableName}`).get();
+            return Number(row?.count ?? 0);
+        });
+    }
+    detectBootstrapSession(db) {
+        const row = db.prepare(`
+      SELECT
+        (SELECT COUNT(*) FROM documents) AS document_count,
+        (SELECT COUNT(*) FROM document_tags) AS document_tag_count,
+        (SELECT COUNT(*) FROM derived_document_tags) AS derived_tag_count
+    `).get();
+        return Number(row?.document_count ?? 0) === 0
+            && Number(row?.document_tag_count ?? 0) === 0
+            && Number(row?.derived_tag_count ?? 0) === 0;
+    }
+    prepareStatements(db) {
+        return {
+            upsertFile: db.prepare(`
+        INSERT INTO files(id, path, dir_path, name, extension, size, mtime, ctime, inode_key, content_hash, status, last_seen_at)
+        VALUES(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'active', ?)
+        ON CONFLICT(path) DO UPDATE SET
+          dir_path = excluded.dir_path,
+          name = excluded.name,
+          extension = excluded.extension,
+          size = excluded.size,
+          mtime = excluded.mtime,
+          ctime = excluded.ctime,
+          inode_key = excluded.inode_key,
+          content_hash = excluded.content_hash,
+          status = 'active',
+          last_seen_at = excluded.last_seen_at
+      `),
+            upsertDocument: db.prepare(`
+        INSERT INTO documents(id, file_id, title, summary, language, parse_status, parse_error, index_status, chunk_count, last_indexed_at)
+        VALUES(?, ?, ?, ?, 'zh', ?, ?, ?, ?, ?)
+        ON CONFLICT(file_id) DO UPDATE SET
+          id = excluded.id,
+          title = excluded.title,
+          summary = excluded.summary,
+          parse_status = excluded.parse_status,
+          parse_error = excluded.parse_error,
+          index_status = excluded.index_status,
+          chunk_count = excluded.chunk_count,
+          last_indexed_at = excluded.last_indexed_at
+      `),
+            insertChunk: db.prepare(`
+        INSERT INTO chunks(id, document_id, chunk_index, content, content_hash, page_no, sheet_name, heading_path, token_count, vector_point_id)
+        VALUES(?, ?, ?, ?, NULL, NULL, NULL, NULL, NULL, NULL)
+      `),
+            insertTag: db.prepare(`
+        INSERT OR IGNORE INTO tags(id, root_type, path, name, parent_id, canonical_name, description, status, created_by, created_at, updated_at, disabled_at)
+        VALUES(?, ?, ?, ?, ?, ?, '', 'active', ?, ?, ?, NULL)
+      `),
+            updateTagDefinition: db.prepare(`
+        UPDATE tags
+        SET root_type = ?,
+            path = ?,
+            name = ?,
+            parent_id = ?,
+            canonical_name = ?,
+            description = ?,
+            status = ?,
+            updated_at = ?,
+            disabled_at = ?
+        WHERE id = ?
+      `),
+            selectTagById: db.prepare(`
+        SELECT id, root_type, path, name, parent_id, canonical_name, description, status, created_by, created_at, updated_at, disabled_at
+        FROM tags
+        WHERE id = ?
+      `),
+            selectTagByPath: db.prepare(`
+        SELECT id, root_type, path, name, parent_id, canonical_name, description, status, created_by, created_at, updated_at, disabled_at
+        FROM tags
+        WHERE path = ?
+      `),
+            selectTagChildrenByParentId: db.prepare(`
+        SELECT id
+        FROM tags
+        WHERE parent_id = ?
+      `),
+            deleteManualDocumentBindingsByDocumentId: db.prepare(`DELETE FROM manual_document_tag_bindings WHERE document_id = ?`),
+            insertManualDocumentBinding: db.prepare(`
+        INSERT OR REPLACE INTO manual_document_tag_bindings(id, document_id, tag_id, source, created_at, updated_at)
+        VALUES(?, ?, ?, ?, ?, ?)
+      `),
+            deleteManualFileBindingsByTagId: db.prepare(`DELETE FROM manual_file_tag_bindings WHERE tag_id = ?`),
+            insertManualFileBinding: db.prepare(`
+        INSERT OR REPLACE INTO manual_file_tag_bindings(id, inode_key, content_hash, file_size, extension, tag_id, source, created_at, updated_at)
+        VALUES(?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `),
+            selectManualFileBindingsForIdentity: db.prepare(`
+        SELECT id
+        FROM manual_file_tag_bindings
+        WHERE (? IS NOT NULL AND inode_key = ?)
+           OR (
+             ? IS NOT NULL
+             AND inode_key IS NULL
+             AND content_hash = ?
+             AND file_size = ?
+             AND extension = ?
+           )
+      `),
+            deleteManualFileBindingById: db.prepare(`DELETE FROM manual_file_tag_bindings WHERE id = ?`),
+            deleteFolderBindingsByFolderPath: db.prepare(`DELETE FROM folder_tag_bindings WHERE folder_path = ?`),
+            insertFolderBinding: db.prepare(`
+        INSERT INTO folder_tag_bindings(id, folder_path, tag_id, apply_mode, created_at, updated_at)
+        VALUES(?, ?, ?, ?, ?, ?)
+      `),
+            deleteTagRulesByTagId: db.prepare(`DELETE FROM tag_rules WHERE tag_id = ?`),
+            insertTagRule: db.prepare(`
+        INSERT INTO tag_rules(id, tag_id, enabled, rule_type, scope_json, matcher_json, min_score, priority, source, created_at, updated_at)
+        VALUES(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `),
+            deleteDocumentTagByPair: db.prepare(`DELETE FROM document_tags WHERE document_id = ? AND tag_id = ?`),
+            deleteDerivedDocumentTagByPair: db.prepare(`DELETE FROM derived_document_tags WHERE document_id = ? AND tag_id = ?`),
+            deleteDocumentTagByDocumentAndSource: db.prepare(`DELETE FROM document_tags WHERE document_id = ? AND source = ?`),
+            deleteDerivedDocumentTagByDocumentAndSource: db.prepare(`DELETE FROM derived_document_tags WHERE document_id = ? AND source = ?`),
+            insertDocumentTag: db.prepare(`
+        INSERT INTO document_tags(id, document_id, tag_id, confidence, source, source_ref, evidence, manual_override, updated_at)
+        VALUES(?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `),
+            insertDerivedTag: db.prepare(`
+        INSERT INTO derived_document_tags(id, document_id, tag_id, source, source_ref, rule_name, evidence, computed_at, updated_at, expires_at)
+        VALUES(?, ?, ?, ?, ?, ?, ?, ?, ?, NULL)
+      `),
+            upsertDocumentTag: db.prepare(`
+        INSERT INTO document_tags(id, document_id, tag_id, confidence, source, source_ref, evidence, manual_override, updated_at)
+        VALUES(?, ?, ?, ?, ?, ?, ?, ?, ?)
+        ON CONFLICT(document_id, tag_id) DO UPDATE SET
+          confidence = excluded.confidence,
+          source = excluded.source,
+          source_ref = excluded.source_ref,
+          evidence = excluded.evidence,
+          manual_override = excluded.manual_override,
+          updated_at = excluded.updated_at
+      `),
+            upsertDerivedTag: db.prepare(`
+        INSERT INTO derived_document_tags(id, document_id, tag_id, source, source_ref, rule_name, evidence, computed_at, updated_at, expires_at)
+        VALUES(?, ?, ?, ?, ?, ?, ?, ?, ?, NULL)
+        ON CONFLICT(document_id, tag_id) DO UPDATE SET
+          source = excluded.source,
+          source_ref = excluded.source_ref,
+          rule_name = excluded.rule_name,
+          evidence = excluded.evidence,
+          computed_at = excluded.computed_at,
+          updated_at = excluded.updated_at,
+          expires_at = excluded.expires_at
+      `),
+            selectActiveFileIdentityByPath: db.prepare(`
+        SELECT
+          d.id AS document_id,
+          f.inode_key,
+          f.content_hash,
+          f.size,
+          f.extension
+        FROM files f
+        JOIN documents d ON d.file_id = f.id
+        WHERE f.path = ?
+          AND f.status = 'active'
+          AND d.index_status IN ('indexed', 'failed', 'skipped')
+      `),
+            selectFileByPath: db.prepare(`SELECT id FROM files WHERE path = ?`),
+            selectDocumentByFileId: db.prepare(`SELECT id FROM documents WHERE file_id = ?`),
+            selectUnseenIdentityCandidates: db.prepare(`
+        SELECT
+          f.id AS file_id,
+          f.path,
+          f.inode_key,
+          f.content_hash,
+          f.size,
+          f.extension,
+          d.id AS document_id
+        FROM files f
+        JOIN documents d ON d.file_id = f.id
+        WHERE f.status = 'active'
+          AND d.index_status IN ('indexed', 'failed', 'skipped')
+          AND f.path <> ?
+          AND f.last_seen_at <> ?
+          AND (
+            (? IS NOT NULL AND f.inode_key = ?)
+            OR (
+              ? IS NOT NULL
+              AND f.content_hash = ?
+              AND f.size = ?
+              AND f.extension = ?
+            )
+          )
+        ORDER BY
+          CASE
+            WHEN ? IS NOT NULL AND f.inode_key = ? THEN 0
+            ELSE 1
+          END,
+          f.last_seen_at DESC,
+          f.path
+      `),
+            selectManualBindingsByDocumentId: db.prepare(`
+        SELECT id, tag_id, source, created_at, updated_at
+        FROM manual_document_tag_bindings
+        WHERE document_id = ?
+        ORDER BY tag_id
+      `),
+            selectManualFileBindingRowsForIdentity: db.prepare(`
+        SELECT id, tag_id, source, created_at, updated_at
+        FROM manual_file_tag_bindings
+        WHERE (? IS NOT NULL AND inode_key = ?)
+           OR (
+             ? IS NOT NULL
+             AND inode_key IS NULL
+             AND content_hash = ?
+             AND file_size = ?
+             AND extension = ?
+           )
+        ORDER BY updated_at DESC, id
+      `),
+            deleteManualBindingByPair: db.prepare(`DELETE FROM manual_document_tag_bindings WHERE document_id = ? AND tag_id = ?`),
+            selectManualDocumentTagsByDocumentId: db.prepare(`
+        SELECT tag_id, confidence, source_ref, evidence, manual_override, updated_at
+        FROM document_tags
+        WHERE document_id = ?
+          AND source = 'manual_document'
+        ORDER BY tag_id
+      `),
+            selectDocumentTagIds: db.prepare(`SELECT tag_id FROM document_tags WHERE document_id = ?`),
+            selectDerivedTagIds: db.prepare(`SELECT tag_id FROM derived_document_tags WHERE document_id = ?`),
+            deleteDocumentTags: db.prepare(`DELETE FROM document_tags WHERE document_id = ?`),
+            deleteDerivedDocumentTags: db.prepare(`DELETE FROM derived_document_tags WHERE document_id = ?`),
+            deleteChunksByDocumentId: db.prepare(`DELETE FROM chunks WHERE document_id = ?`),
+            deleteDocumentById: db.prepare(`DELETE FROM documents WHERE id = ?`),
+            markFileDeleted: db.prepare(`
+        UPDATE files
+        SET status = 'deleted',
+            last_seen_at = ?
+        WHERE id = ?
+      `),
+            listActiveFilesAll: db.prepare(`SELECT path, last_seen_at FROM files WHERE status = 'active'`),
+            listActiveFilesExact: db.prepare(`SELECT path, last_seen_at FROM files WHERE status = 'active' AND path = ?`),
+            listActiveFilesPrefix: db.prepare(`SELECT path, last_seen_at FROM files WHERE status = 'active' AND (path = ? OR path LIKE ?)`),
+            countActiveIndexedDocuments: db.prepare(`
+        SELECT COUNT(*) AS count
+        FROM documents d
+        JOIN files f ON f.id = d.file_id
+        WHERE f.status = 'active'
+          AND d.index_status = 'indexed'
+      `),
+            selectActiveIndexedFileStateByPath: db.prepare(`
+        SELECT
+          f.path,
+          f.extension,
+          f.size,
+          f.mtime,
+          d.index_status
+        FROM files f
+        JOIN documents d ON d.file_id = f.id
+        WHERE f.path = ?
+          AND f.status = 'active'
+          AND d.index_status IN ('indexed', 'failed', 'skipped')
+        LIMIT 1
+      `),
+        };
+    }
+    ensureTagInConnection(db, statements, tagCache, tagPath, createdBy) {
+        const cached = tagCache.get(tagPath);
+        if (cached) {
+            const existingById = statements.selectTagById.get(cached);
+            if (existingById?.id && existingById.path === tagPath) {
+                return cached;
+            }
+            tagCache.delete(tagPath);
+            this.invalidateCachedTagPath(tagPath);
+        }
+        const existingByPath = statements.selectTagByPath.get(tagPath);
+        if (existingByPath?.id) {
+            tagCache.set(tagPath, existingByPath.id);
+            this.tagIdCache.set(tagPath, existingByPath.id);
+            return existingByPath.id;
+        }
+        const segments = tagPath.split("/").filter(Boolean);
+        const rootType = segments[0] ?? "未分类";
+        const parentPath = segments.length > 1 ? segments.slice(0, -1).join("/") : null;
+        const parentId = parentPath ? this.ensureTagInConnection(db, statements, tagCache, parentPath, createdBy) : null;
+        const name = segments[segments.length - 1] ?? rootType;
+        const tagId = makeStableId("tag", tagPath);
+        statements.insertTag.run(tagId, rootType, tagPath, name, parentId, name, createdBy, new Date().toISOString(), new Date().toISOString());
+        tagCache.set(tagPath, tagId);
+        this.tagIdCache.set(tagPath, tagId);
+        return tagId;
+    }
+    cleanupOrphanTagsInConnection(db) {
+        const selectOrphans = db.prepare(`
+      SELECT t.id, t.path
+      FROM tags t
+      WHERE NOT EXISTS (
+        SELECT 1 FROM tags child WHERE child.parent_id = t.id
+      )
+      AND NOT EXISTS (
+        SELECT 1 FROM document_tags dt WHERE dt.tag_id = t.id
+      )
+      AND NOT EXISTS (
+        SELECT 1 FROM derived_document_tags ddt WHERE ddt.tag_id = t.id
+      )
+      AND NOT EXISTS (
+        SELECT 1 FROM tag_aliases ta WHERE ta.tag_id = t.id
+      )
+      AND NOT EXISTS (
+        SELECT 1 FROM tag_rules tr WHERE tr.tag_id = t.id
+      )
+      AND NOT EXISTS (
+        SELECT 1 FROM manual_document_tag_bindings mdtb WHERE mdtb.tag_id = t.id
+      )
+      AND NOT EXISTS (
+        SELECT 1 FROM manual_file_tag_bindings mftb WHERE mftb.tag_id = t.id
+      )
+      AND NOT EXISTS (
+        SELECT 1 FROM folder_tag_bindings ftb WHERE ftb.tag_id = t.id
+      )
+    `);
+        const deleteTag = db.prepare(`DELETE FROM tags WHERE id = ?`);
+        while (true) {
+            const orphanRows = selectOrphans.all();
+            if (orphanRows.length === 0) {
+                return;
+            }
+            for (const row of orphanRows) {
+                deleteTag.run(row.id);
+                this.invalidateCachedTagPath(row.path);
+            }
+        }
+    }
+    buildDocumentIdentityFingerprint(file, document) {
+        return {
+            inodeKey: normalizeFileIdentityValue(file.inodeKey),
+            contentHash: buildDocumentContentHash(document.text),
+        };
+    }
+    resolveMigrationCandidateInConnection(statements, file, fingerprint, observedAt) {
+        if (!fingerprint.inodeKey && !fingerprint.contentHash) {
+            return null;
+        }
+        const rows = statements.selectUnseenIdentityCandidates.all(file.relativePath, observedAt, fingerprint.inodeKey, fingerprint.inodeKey, fingerprint.contentHash, fingerprint.contentHash, file.size, file.extension, fingerprint.inodeKey, fingerprint.inodeKey);
+        if (rows.length === 0) {
+            return null;
+        }
+        const candidates = rows.map((row) => ({
+            fileId: String(row.file_id),
+            path: String(row.path),
+            documentId: String(row.document_id),
+            inodeKey: normalizeFileIdentityValue(row.inode_key),
+            contentHash: typeof row.content_hash === "string" && row.content_hash.trim() ? row.content_hash : null,
+            size: Number(row.size ?? 0),
+            extension: String(row.extension ?? ""),
+        }));
+        const inodeMatches = fingerprint.inodeKey
+            ? candidates.filter((candidate) => candidate.inodeKey === fingerprint.inodeKey)
+            : [];
+        if (inodeMatches.length === 1) {
+            return inodeMatches[0];
+        }
+        if (inodeMatches.length > 1) {
+            return null;
+        }
+        const contentMatches = fingerprint.contentHash
+            ? candidates.filter((candidate) => candidate.contentHash === fingerprint.contentHash
+                && candidate.size === file.size
+                && candidate.extension === file.extension
+                && !doesSiblingPathStillExist(file, candidate.path))
+            : [];
+        if (contentMatches.length === 1) {
+            return contentMatches[0];
+        }
+        return null;
+    }
+    migrateManualBindingsInConnection(statements, previousDocumentId, nextDocumentId, observedAt) {
+        if (!previousDocumentId || !nextDocumentId || previousDocumentId === nextDocumentId) {
+            return;
+        }
+        const bindingRows = statements.selectManualBindingsByDocumentId.all(previousDocumentId);
+        bindingRows.forEach((row) => {
+            const tagId = String(row.tag_id);
+            statements.insertManualDocumentBinding.run(makeStableId("manual_binding", `${nextDocumentId}:${tagId}`), nextDocumentId, tagId, String(row.source ?? "manual_document"), String(row.created_at ?? observedAt), observedAt);
+            statements.deleteManualBindingByPair.run(previousDocumentId, tagId);
+        });
+        const manualTagRows = statements.selectManualDocumentTagsByDocumentId.all(previousDocumentId);
+        manualTagRows.forEach((row) => {
+            const tagId = String(row.tag_id);
+            statements.upsertDocumentTag.run(makeStableId("doc_tag", `${nextDocumentId}:${tagId}`), nextDocumentId, tagId, Number(row.confidence ?? 1), "manual_document", typeof row.source_ref === "string" ? row.source_ref : null, typeof row.evidence === "string" ? row.evidence : "手动分配", Number(row.manual_override ?? 1) ? 1 : 0, observedAt);
+        });
+    }
+    deleteManualFileBindingsForTargetInConnection(statements, target) {
+        const existingRows = statements.selectManualFileBindingsForIdentity.all(target.inodeKey, target.inodeKey, target.contentHash, target.contentHash, target.size, target.extension);
+        existingRows.forEach((row) => {
+            statements.deleteManualFileBindingById.run(String(row.id));
+        });
+    }
+    buildManualBindingTarget(file, fingerprint, documentId) {
+        return {
+            documentId,
+            inodeKey: fingerprint.inodeKey,
+            contentHash: fingerprint.contentHash,
+            size: file.size,
+            extension: file.extension,
+        };
+    }
+    getActiveManualBindingTargetByPathInConnection(statements, relativePath) {
+        const row = statements.selectActiveFileIdentityByPath.get(relativePath);
+        if (!row?.document_id) {
+            return null;
+        }
+        return {
+            documentId: String(row.document_id),
+            inodeKey: normalizeFileIdentityValue(row.inode_key),
+            contentHash: typeof row.content_hash === "string" && row.content_hash.trim() ? String(row.content_hash) : null,
+            size: Number(row.size ?? 0),
+            extension: String(row.extension ?? ""),
+        };
+    }
+    listManualFileBindingRowsForIdentityInConnection(statements, target) {
+        if (!target.inodeKey && !target.contentHash) {
+            return [];
+        }
+        const rows = statements.selectManualFileBindingRowsForIdentity.all(target.inodeKey, target.inodeKey, target.contentHash, target.contentHash, target.size, target.extension);
+        return rows.map((row) => ({
+            id: String(row.id),
+            tagId: String(row.tag_id),
+            source: String(row.source ?? "manual_document"),
+            createdAt: String(row.created_at),
+            updatedAt: String(row.updated_at),
+        }));
+    }
+    carryForwardManualFileBindingsForSameDocumentInConnection(statements, previousTarget, nextTarget, observedAt) {
+        if (!previousTarget || previousTarget.documentId !== nextTarget.documentId) {
+            return;
+        }
+        if (hasSameManualBindingIdentity(previousTarget, nextTarget)) {
+            return;
+        }
+        const existingNextRows = this.listManualFileBindingRowsForIdentityInConnection(statements, nextTarget);
+        if (existingNextRows.length > 0) {
+            return;
+        }
+        const previousRows = this.listManualFileBindingRowsForIdentityInConnection(statements, previousTarget);
+        if (previousRows.length === 0) {
+            return;
+        }
+        previousRows.forEach((row) => {
+            statements.insertManualFileBinding.run(makeStableId("manual_file_binding", serializeManualFileBindingIdentity(nextTarget, row.tagId)), nextTarget.inodeKey, nextTarget.contentHash, nextTarget.size, nextTarget.extension, row.tagId, row.source, row.createdAt, observedAt);
+            statements.deleteManualFileBindingById.run(row.id);
+        });
+    }
+    resolveManualFileBindingsForTargetInConnection(db, target) {
+        if (!target.inodeKey && !target.contentHash) {
+            return [];
+        }
+        const candidateRows = db.prepare(`
+      SELECT id, inode_key, content_hash, file_size, extension, tag_id, source, created_at, updated_at
+      FROM manual_file_tag_bindings
+      WHERE (? IS NOT NULL AND inode_key = ?)
+         OR (? IS NOT NULL AND content_hash = ? AND file_size = ? AND extension = ?)
+      ORDER BY updated_at DESC, id
+    `).all(target.inodeKey, target.inodeKey, target.contentHash, target.contentHash, target.size, target.extension);
+        if (candidateRows.length === 0) {
+            return [];
+        }
+        const candidateInodeKeys = [...new Set(candidateRows
+                .map((row) => normalizeFileIdentityValue(row.inode_key))
+                .filter((value) => Boolean(value)))];
+        const candidateContentHashes = [...new Set(candidateRows
+                .map((row) => typeof row.content_hash === "string" && row.content_hash.trim() ? String(row.content_hash) : null)
+                .filter((value) => Boolean(value)))];
+        const activeIdentityRows = this.listActiveDocumentIdentityRowsInConnection(db, candidateInodeKeys, candidateContentHashes);
+        const activeDocIdsByInode = buildIdentityDocumentIdsByInode(activeIdentityRows);
+        const activeDocIdsByContent = buildIdentityDocumentIdsByContent(activeIdentityRows);
+        const targetContentKey = buildIdentityContentKey(target.contentHash, target.size, target.extension);
+        return candidateRows
+            .filter((row) => {
+            const candidateInodeKey = normalizeFileIdentityValue(row.inode_key);
+            if (candidateInodeKey && target.inodeKey && candidateInodeKey === target.inodeKey) {
+                return true;
+            }
+            const candidateContentKey = buildIdentityContentKey(typeof row.content_hash === "string" && row.content_hash.trim() ? String(row.content_hash) : null, Number(row.file_size ?? 0), String(row.extension ?? ""));
+            if (!candidateContentKey || !targetContentKey || candidateContentKey !== targetContentKey) {
+                return false;
+            }
+            const contentMatches = activeDocIdsByContent.get(candidateContentKey);
+            if (contentMatches !== 1) {
+                return false;
+            }
+            if (!candidateInodeKey) {
+                return true;
+            }
+            return !activeDocIdsByInode.has(candidateInodeKey);
+        })
+            .map((row) => ({
+            id: String(row.id),
+            tagId: String(row.tag_id),
+            source: String(row.source ?? "manual_document"),
+            createdAt: String(row.created_at),
+            updatedAt: String(row.updated_at),
+        }));
+    }
+    listActiveDocumentIdentityRowsInConnection(db, inodeKeys, contentHashes) {
+        if (inodeKeys.length === 0 && contentHashes.length === 0) {
+            return [];
+        }
+        const predicateParts = [];
+        const params = [];
+        if (inodeKeys.length > 0) {
+            predicateParts.push(`f.inode_key IN (${inodeKeys.map(() => "?").join(", ")})`);
+            params.push(...inodeKeys);
+        }
+        if (contentHashes.length > 0) {
+            predicateParts.push(`f.content_hash IN (${contentHashes.map(() => "?").join(", ")})`);
+            params.push(...contentHashes);
+        }
+        const rows = db.prepare(`
+      SELECT f.inode_key, f.content_hash, f.size, f.extension
+      FROM documents d
+      JOIN files f ON f.id = d.file_id
+      WHERE f.status = 'active'
+        AND d.index_status = 'indexed'
+        AND (${predicateParts.join(" OR ")})
+    `).all(...params);
+        return rows.map((row) => ({
+            inodeKey: normalizeFileIdentityValue(row.inode_key),
+            contentHash: typeof row.content_hash === "string" && row.content_hash.trim() ? String(row.content_hash) : null,
+            size: Number(row.size ?? 0),
+            extension: String(row.extension ?? ""),
+        }));
+    }
+    syncManualResolvedTagsForDocumentInConnection(db, statements, target, observedAt) {
+        const existingManualTagRows = statements.selectManualDocumentTagsByDocumentId.all(target.documentId);
+        this.backfillManualFileBindingsFromLegacyDocumentBindingsInConnection(statements, target, observedAt);
+        statements.deleteDocumentTagByDocumentAndSource.run(target.documentId, "manual_document");
+        let manualBindings = this.resolveManualFileBindingsForTargetInConnection(db, target);
+        if (manualBindings.length === 0 && existingManualTagRows.length > 0 && (target.inodeKey || target.contentHash)) {
+            existingManualTagRows.forEach((row) => {
+                const tagId = String(row.tag_id);
+                statements.insertManualFileBinding.run(makeStableId("manual_file_binding", serializeManualFileBindingIdentity(target, tagId)), target.inodeKey, target.contentHash, target.size, target.extension, tagId, "manual_document", String(row.updated_at ?? observedAt), observedAt);
+            });
+            manualBindings = this.resolveManualFileBindingsForTargetInConnection(db, target);
+        }
+        manualBindings.forEach((binding) => {
+            statements.upsertDocumentTag.run(makeStableId("doc_tag", `${target.documentId}:${binding.tagId}`), target.documentId, binding.tagId, 1, "manual_document", binding.id, "手动分配", 1, observedAt);
+        });
+    }
+    backfillManualFileBindingsFromLegacyDocumentBindingsInConnection(statements, target, observedAt) {
+        if (!target.inodeKey && !target.contentHash) {
+            return;
+        }
+        const existingIdentityRows = statements.selectManualFileBindingsForIdentity.all(target.inodeKey, target.inodeKey, target.contentHash, target.contentHash, target.size, target.extension);
+        if (existingIdentityRows.length > 0) {
+            return;
+        }
+        const legacyRows = statements.selectManualBindingsByDocumentId.all(target.documentId);
+        legacyRows.forEach((row) => {
+            const tagId = String(row.tag_id);
+            statements.insertManualFileBinding.run(makeStableId("manual_file_binding", serializeManualFileBindingIdentity(target, tagId)), target.inodeKey, target.contentHash, target.size, target.extension, tagId, String(row.source ?? "manual_document"), String(row.created_at ?? observedAt), observedAt);
+        });
+    }
+    deleteDocumentInConnection(db, statements, relativePath, deletedAt) {
+        const normalizedPath = this.normalizeRelativePath(relativePath);
+        const fileRow = statements.selectFileByPath.get(normalizedPath);
+        if (!fileRow?.id) {
+            return false;
+        }
+        const documentRow = statements.selectDocumentByFileId.get(fileRow.id);
+        if (documentRow?.id) {
+            statements.deleteChunksByDocumentId.run(documentRow.id);
+            statements.deleteManualDocumentBindingsByDocumentId.run(documentRow.id);
+            statements.deleteDocumentTags.run(documentRow.id);
+            statements.deleteDerivedDocumentTags.run(documentRow.id);
+            statements.deleteDocumentById.run(documentRow.id);
+        }
+        statements.markFileDeleted.run(deletedAt, fileRow.id);
+        return true;
+    }
+    upsertDocumentInConnection(db, statements, tagCache, file, document, tags = [], derivedTags = [], observedAt = new Date().toISOString()) {
+        const fileId = makeStableId("file", file.relativePath);
+        const documentId = makeStableId("doc", file.relativePath);
+        const fingerprint = this.buildDocumentIdentityFingerprint(file, document);
+        const previousManualBindingTarget = this.getActiveManualBindingTargetByPathInConnection(statements, file.relativePath);
+        const migrationCandidate = this.resolveMigrationCandidateInConnection(statements, file, fingerprint, observedAt);
+        const manualBindingTarget = this.buildManualBindingTarget(file, fingerprint, documentId);
+        statements.upsertFile.run(fileId, file.relativePath, file.relativePath.includes("/") ? file.relativePath.slice(0, file.relativePath.lastIndexOf("/")) : ".", file.name, file.extension, file.size, file.mtime, file.ctime, fingerprint.inodeKey, fingerprint.contentHash, observedAt);
+        statements.upsertDocument.run(documentId, fileId, document.title, document.summary, "parsed", null, "indexed", document.text.trim() ? 1 : 0, observedAt);
+        if (migrationCandidate) {
+            this.migrateManualBindingsInConnection(statements, migrationCandidate.documentId, documentId, observedAt);
+        }
+        this.carryForwardManualFileBindingsForSameDocumentInConnection(statements, previousManualBindingTarget, manualBindingTarget, observedAt);
+        this.syncManualResolvedTagsForDocumentInConnection(db, statements, manualBindingTarget, observedAt);
+        statements.deleteChunksByDocumentId.run(documentId);
+        if (document.text.trim()) {
+            statements.insertChunk.run(makeStableId("chunk", `${documentId}:0`), documentId, 0, document.text);
+        }
+        if (this.activeBootstrapSession) {
+            for (const tag of tags) {
+                const tagId = this.ensureTagInConnection(db, statements, tagCache, tag.tagPath, tag.source.split("+")[0] || "rule");
+                statements.insertDocumentTag.run(makeStableId("doc_tag", `${documentId}:${tagId}`), documentId, tagId, tag.confidence, tag.source, null, tag.evidence, tag.manualOverride ? 1 : 0, observedAt);
+            }
+            for (const tag of derivedTags) {
+                const tagId = this.ensureTagInConnection(db, statements, tagCache, tag.tagPath, tag.source);
+                statements.insertDerivedTag.run(makeStableId("derived_tag", `${documentId}:${tagId}`), documentId, tagId, "system_derived", null, tag.source, tag.evidence, observedAt, observedAt);
+            }
+            return { fileId, documentId };
+        }
+        for (const tag of tags) {
+            const tagId = this.ensureTagInConnection(db, statements, tagCache, tag.tagPath, tag.source.split("+")[0] || "rule");
+            statements.upsertDocumentTag.run(makeStableId("doc_tag", `${documentId}:${tagId}`), documentId, tagId, tag.confidence, tag.source, null, tag.evidence, tag.manualOverride ? 1 : 0, observedAt);
+        }
+        const existingDerivedTagRows = statements.selectDerivedTagIds.all(documentId);
+        const existingDerivedTagIds = new Set(existingDerivedTagRows.map(row => String(row.tag_id)));
+        const nextDerivedTagIds = new Set();
+        for (const tag of derivedTags) {
+            const tagId = this.ensureTagInConnection(db, statements, tagCache, tag.tagPath, tag.source);
+            nextDerivedTagIds.add(tagId);
+            statements.upsertDerivedTag.run(makeStableId("derived_tag", `${documentId}:${tagId}`), documentId, tagId, "system_derived", null, tag.source, tag.evidence, observedAt, observedAt);
+        }
+        for (const tagId of existingDerivedTagIds) {
+            if (!nextDerivedTagIds.has(tagId)) {
+                statements.deleteDerivedDocumentTagByPair.run(documentId, tagId);
+            }
+        }
+        return { fileId, documentId };
+    }
+    upsertParseFailureInConnection(db, statements, file, error, observedAt = new Date().toISOString()) {
+        const fileId = makeStableId("file", file.relativePath);
+        const documentId = makeStableId("doc", file.relativePath);
+        const inodeKey = normalizeFileIdentityValue(file.inodeKey);
+        statements.upsertFile.run(fileId, file.relativePath, file.relativePath.includes("/") ? file.relativePath.slice(0, file.relativePath.lastIndexOf("/")) : ".", file.name, file.extension, file.size, file.mtime, file.ctime, inodeKey, null, observedAt);
+        statements.upsertDocument.run(documentId, fileId, file.name, "", "failed", error.message, "failed", 0, observedAt);
+        statements.deleteChunksByDocumentId.run(documentId);
+        statements.deleteDocumentTags.run(documentId);
+        statements.deleteDerivedDocumentTags.run(documentId);
+        return { fileId, documentId };
+    }
+    markSkippedDocumentInConnection(db, statements, entry, observedAt = new Date().toISOString()) {
+        const { file, adapter, reasonCode, message } = entry;
+        const fileId = makeStableId("file", file.relativePath);
+        const documentId = makeStableId("doc", file.relativePath);
+        const inodeKey = normalizeFileIdentityValue(file.inodeKey);
+        statements.upsertFile.run(fileId, file.relativePath, file.relativePath.includes("/") ? file.relativePath.slice(0, file.relativePath.lastIndexOf("/")) : ".", file.name, file.extension, file.size, file.mtime, file.ctime, inodeKey, null, observedAt);
+        statements.upsertDocument.run(documentId, fileId, file.name, "", "skipped", `${reasonCode}: ${adapter}${message ? ` - ${message}` : ""}`, "skipped", 0, observedAt);
+        statements.deleteChunksByDocumentId.run(documentId);
+        statements.deleteDocumentTags.run(documentId);
+        statements.deleteDerivedDocumentTags.run(documentId);
+        statements.deleteChunksByDocumentId.run(documentId);
+        return { fileId, documentId };
+    }
+    upsertTextDocument(file, parsed, tags = [], derivedTags = [], observedAt) {
+        return this.withConnection((db, statements) => {
+            const tagCache = new Map(this.tagIdCache);
+            try {
+                db.exec("BEGIN");
+                const result = this.upsertDocumentInConnection(db, statements, tagCache, file, parsed, tags, derivedTags, observedAt);
+                db.exec("COMMIT");
+                return result;
+            }
+            catch (error) {
+                db.exec("ROLLBACK");
+                throw error;
+            }
+        });
+    }
+    upsertParseFailure(file, error, observedAt) {
+        return this.withConnection((db, statements) => {
+            try {
+                db.exec("BEGIN");
+                const result = this.upsertParseFailureInConnection(db, statements, file, error, observedAt);
+                this.cleanupOrphanTagsInConnection(db);
+                db.exec("COMMIT");
+                return result;
+            }
+            catch (failure) {
+                db.exec("ROLLBACK");
+                throw failure;
+            }
+        });
+    }
+    batchUpsertDocuments(entries, observedAt) {
+        if (entries.length === 0) {
+            return [];
+        }
+        return this.withConnection((db, statements) => {
+            const tagCache = new Map(this.tagIdCache);
+            try {
+                db.exec("BEGIN IMMEDIATE");
+                const results = entries.map(entry => this.upsertDocumentInConnection(db, statements, tagCache, entry.file, entry.document, entry.tags, entry.derivedTags, observedAt));
+                db.exec("COMMIT");
+                return results;
+            }
+            catch (error) {
+                db.exec("ROLLBACK");
+                throw error;
+            }
+        });
+    }
+    batchUpsertParseFailures(entries, observedAt) {
+        if (entries.length === 0) {
+            return [];
+        }
+        return this.withConnection((db, statements) => {
+            try {
+                db.exec("BEGIN IMMEDIATE");
+                const results = entries.map(entry => this.upsertParseFailureInConnection(db, statements, entry.file, entry.error, observedAt));
+                db.exec("COMMIT");
+                return results;
+            }
+            catch (error) {
+                db.exec("ROLLBACK");
+                throw error;
+            }
+        });
+    }
+    batchMarkSkippedDocuments(entries, observedAt) {
+        if (entries.length === 0) {
+            return [];
+        }
+        return this.withConnection((db, statements) => {
+            try {
+                db.exec("BEGIN IMMEDIATE");
+                const results = entries.map(entry => this.markSkippedDocumentInConnection(db, statements, entry, observedAt));
+                db.exec("COMMIT");
+                return results;
+            }
+            catch (error) {
+                db.exec("ROLLBACK");
+                throw error;
+            }
+        });
+    }
+    cleanupOrphanTags() {
+        this.withConnection(db => {
+            try {
+                db.exec("BEGIN IMMEDIATE");
+                this.cleanupOrphanTagsInConnection(db);
+                db.exec("COMMIT");
+            }
+            catch (error) {
+                db.exec("ROLLBACK");
+                throw error;
+            }
+        });
+    }
+    getActiveIndexedFileState(relativePath) {
+        return this.withConnection((_, statements) => {
+            const normalizedPath = this.normalizeRelativePath(relativePath);
+            const row = statements.selectActiveIndexedFileStateByPath.get(normalizedPath);
+            if (!row?.path) {
+                return null;
+            }
+            return {
+                path: String(row.path),
+                extension: String(row.extension ?? ""),
+                size: Number(row.size ?? 0),
+                mtime: String(row.mtime ?? ""),
+                indexStatus: String(row.index_status ?? ""),
+            };
+        });
+    }
+    reconcileScope(scope, observedAt, options = {}) {
+        return this.withConnection((db, statements) => {
+            const now = new Date().toISOString();
+            try {
+                db.exec("BEGIN IMMEDIATE");
+                let rows = [];
+                if (scope.kind === "exact" && scope.value) {
+                    rows = statements.listActiveFilesExact.all(this.normalizeRelativePath(scope.value));
+                }
+                else if (scope.kind === "prefix" && scope.value) {
+                    const normalizedPrefix = this.normalizeRelativePath(scope.value).replace(/\/+$/, "");
+                    rows = statements.listActiveFilesPrefix.all(normalizedPrefix, `${normalizedPrefix}/%`);
+                }
+                else {
+                    rows = statements.listActiveFilesAll.all();
+                }
+                const deletedPaths = [];
+                for (const row of rows) {
+                    if (options.seenPaths?.has(row.path) || row.last_seen_at === observedAt) {
+                        continue;
+                    }
+                    if (this.deleteDocumentInConnection(db, statements, row.path, now)) {
+                        deletedPaths.push(row.path);
+                    }
+                }
+                this.cleanupOrphanTagsInConnection(db);
+                db.exec("COMMIT");
+                return {
+                    deletedCount: deletedPaths.length,
+                    deletedPaths,
+                };
+            }
+            catch (error) {
+                db.exec("ROLLBACK");
+                throw error;
+            }
+        });
+    }
+    deleteActiveFilesByExtensions(extensions, deletedAt = new Date().toISOString()) {
+        const normalizedExtensions = [...new Set(extensions
+                .map(item => item.trim().toLowerCase())
+                .filter(Boolean)
+                .map(item => item.startsWith(".") ? item : `.${item}`))];
+        if (normalizedExtensions.length === 0) {
+            return {
+                deletedCount: 0,
+                deletedPaths: [],
+            };
+        }
+        return this.withConnection((db, statements) => {
+            try {
+                db.exec("BEGIN IMMEDIATE");
+                const placeholders = normalizedExtensions.map(() => "?").join(", ");
+                const rows = db.prepare(`
+          SELECT path
+          FROM files
+          WHERE status = 'active'
+            AND extension IN (${placeholders})
+          ORDER BY path
+        `).all(...normalizedExtensions);
+                const deletedPaths = [];
+                for (const row of rows) {
+                    if (this.deleteDocumentInConnection(db, statements, row.path, deletedAt)) {
+                        deletedPaths.push(String(row.path));
+                    }
+                }
+                this.cleanupOrphanTagsInConnection(db);
+                db.exec("COMMIT");
+                return {
+                    deletedCount: deletedPaths.length,
+                    deletedPaths,
+                };
+            }
+            catch (error) {
+                db.exec("ROLLBACK");
+                throw error;
+            }
+        });
+    }
+    recomputeDocumentTags(entries, observedAt = new Date().toISOString()) {
+        if (entries.length === 0) {
+            return { updatedCount: 0 };
+        }
+        return this.withConnection((db, statements) => {
+            const tagCache = new Map(this.tagIdCache);
+            try {
+                db.exec("BEGIN IMMEDIATE");
+                for (const entry of entries) {
+                    statements.deleteDocumentTags.run(entry.documentId);
+                    statements.deleteDerivedDocumentTags.run(entry.documentId);
+                    for (const tag of entry.tags) {
+                        const tagId = this.ensureTagInConnection(db, statements, tagCache, tag.tagPath, tag.source.split("+")[0] || "rule");
+                        statements.upsertDocumentTag.run(makeStableId("doc_tag", `${entry.documentId}:${tagId}`), entry.documentId, tagId, tag.confidence, tag.source, null, tag.evidence, tag.manualOverride ? 1 : 0, observedAt);
+                    }
+                    for (const tag of entry.derivedTags) {
+                        const tagId = this.ensureTagInConnection(db, statements, tagCache, tag.tagPath, tag.source);
+                        statements.upsertDerivedTag.run(makeStableId("derived_tag", `${entry.documentId}:${tagId}`), entry.documentId, tagId, "system_derived", null, tag.source, tag.evidence, observedAt, observedAt);
+                    }
+                }
+                this.cleanupOrphanTagsInConnection(db);
+                db.exec("COMMIT");
+                return { updatedCount: entries.length };
+            }
+            catch (error) {
+                db.exec("ROLLBACK");
+                throw error;
+            }
+        });
+    }
+    saveTagDefinition(input, observedAt = new Date().toISOString()) {
+        return this.withConnection((db, statements) => {
+            try {
+                db.exec("BEGIN IMMEDIATE");
+                const tagId = input.id?.trim() || makeStableId("tag", input.path);
+                const disabledAt = input.status === "disabled" ? observedAt : null;
+                const existing = statements.selectTagById.get(tagId);
+                if (existing?.id) {
+                    statements.updateTagDefinition.run(input.rootType, input.path, input.name, input.parentId ?? null, input.canonicalName ?? input.name, input.description ?? null, input.status, observedAt, disabledAt, tagId);
+                    if (typeof existing.path === "string" && existing.path && existing.path !== input.path) {
+                        this.tagIdCache.delete(existing.path);
+                    }
+                }
+                else {
+                    db.prepare(`
+            INSERT INTO tags(id, root_type, path, name, parent_id, canonical_name, description, status, created_by, created_at, updated_at, disabled_at)
+            VALUES(?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+          `).run(tagId, input.rootType, input.path, input.name, input.parentId ?? null, input.canonicalName ?? input.name, input.description ?? null, input.status, input.createdBy, observedAt, observedAt, disabledAt);
+                }
+                this.tagIdCache.set(input.path, tagId);
+                db.exec("COMMIT");
+                return { id: tagId };
+            }
+            catch (error) {
+                db.exec("ROLLBACK");
+                throw error;
+            }
+        });
+    }
+    replaceTagRules(tagId, rules, observedAt = new Date().toISOString()) {
+        const normalizedTagId = tagId.trim();
+        if (!normalizedTagId) {
+            return;
+        }
+        this.withConnection((db, statements) => {
+            try {
+                db.exec("BEGIN IMMEDIATE");
+                statements.deleteTagRulesByTagId.run(normalizedTagId);
+                rules
+                    .filter(rule => Number.isFinite(rule.priority))
+                    .sort((left, right) => left.priority - right.priority)
+                    .forEach((rule, index) => {
+                    const priority = Number.isFinite(rule.priority) ? rule.priority : index;
+                    const relation = rule.relation === "or" || rule.relation === "not" ? rule.relation : "and";
+                    const scopeJson = JSON.stringify({ relation });
+                    const matcherJson = JSON.stringify(rule.matcher ?? {});
+                    const ruleId = makeStableId("tag_rule", `${normalizedTagId}:${priority}:${rule.ruleType}:${matcherJson}:${relation}`);
+                    statements.insertTagRule.run(ruleId, normalizedTagId, rule.enabled ? 1 : 0, rule.ruleType, scopeJson, matcherJson, null, priority, "smart_rule", observedAt, observedAt);
+                });
+                db.exec("COMMIT");
+            }
+            catch (error) {
+                db.exec("ROLLBACK");
+                throw error;
+            }
+        });
+    }
+    replaceManualDocumentTagBindings(target, tagIds, observedAt = new Date().toISOString()) {
+        const normalizedTagIds = [...new Set(tagIds.map(item => item.trim()).filter(Boolean))];
+        this.withConnection((db, statements) => {
+            try {
+                db.exec("BEGIN IMMEDIATE");
+                // 旧 manual_document_tag_bindings 现在只保留给历史数据兼容。
+                // 新写入统一只进 manual_file_tag_bindings，避免继续把 document_id 绑定当主链路。
+                statements.deleteManualDocumentBindingsByDocumentId.run(target.documentId);
+                this.deleteManualFileBindingsForTargetInConnection(statements, target);
+                normalizedTagIds.forEach(tagId => {
+                    statements.insertManualFileBinding.run(makeStableId("manual_file_binding", serializeManualFileBindingIdentity(target, tagId)), target.inodeKey, target.contentHash, target.size, target.extension, tagId, "manual_document", observedAt, observedAt);
+                });
+                db.exec("COMMIT");
+            }
+            catch (error) {
+                db.exec("ROLLBACK");
+                throw error;
+            }
+        });
+    }
+    replaceFolderTagBindings(folderPath, tagIds, observedAt = new Date().toISOString()) {
+        const normalizedFolderPath = this.normalizeRelativePath(folderPath).replace(/^\.\/+/, "").replace(/\/+$/g, "") || ".";
+        const normalizedTagIds = [...new Set(tagIds.map(item => item.trim()).filter(Boolean))];
+        this.withConnection((db, statements) => {
+            try {
+                db.exec("BEGIN IMMEDIATE");
+                statements.deleteFolderBindingsByFolderPath.run(normalizedFolderPath);
+                normalizedTagIds.forEach(tagId => {
+                    statements.insertFolderBinding.run(makeStableId("folder_binding", `${normalizedFolderPath}:${tagId}:descendant_files`), normalizedFolderPath, tagId, "descendant_files", observedAt, observedAt);
+                });
+                db.exec("COMMIT");
+            }
+            catch (error) {
+                db.exec("ROLLBACK");
+                throw error;
+            }
+        });
+    }
+    deleteTagDefinitions(tagIds) {
+        const normalizedTagIds = [...new Set(tagIds.map(item => item.trim()).filter(Boolean))];
+        if (normalizedTagIds.length === 0) {
+            return;
+        }
+        this.withConnection((db, statements) => {
+            try {
+                db.exec("BEGIN IMMEDIATE");
+                const selectTagPath = db.prepare(`SELECT path FROM tags WHERE id = ?`);
+                const deleteManualBindings = db.prepare(`DELETE FROM manual_document_tag_bindings WHERE tag_id = ?`);
+                const deleteManualFileBindings = statements.deleteManualFileBindingsByTagId;
+                const deleteFolderBindings = db.prepare(`DELETE FROM folder_tag_bindings WHERE tag_id = ?`);
+                const deleteRules = db.prepare(`DELETE FROM tag_rules WHERE tag_id = ?`);
+                const deleteDocumentTags = db.prepare(`DELETE FROM document_tags WHERE tag_id = ?`);
+                const deleteDerivedTags = db.prepare(`DELETE FROM derived_document_tags WHERE tag_id = ?`);
+                const deleteTag = db.prepare(`DELETE FROM tags WHERE id = ?`);
+                normalizedTagIds.forEach((tagId) => {
+                    const current = selectTagPath.get(tagId);
+                    deleteManualBindings.run(tagId);
+                    deleteManualFileBindings.run(tagId);
+                    deleteFolderBindings.run(tagId);
+                    deleteRules.run(tagId);
+                    deleteDocumentTags.run(tagId);
+                    deleteDerivedTags.run(tagId);
+                    deleteTag.run(tagId);
+                    if (typeof current?.path === "string" && current.path) {
+                        this.tagIdCache.delete(current.path);
+                    }
+                });
+                db.exec("COMMIT");
+            }
+            catch (error) {
+                db.exec("ROLLBACK");
+                throw error;
+            }
+        });
+    }
+    deleteResolvedTagsBySource(documentId, sourceTypes) {
+        const normalizedTypes = [...new Set(sourceTypes)];
+        if (normalizedTypes.length === 0) {
+            return;
+        }
+        this.withConnection((db, statements) => {
+            try {
+                db.exec("BEGIN IMMEDIATE");
+                normalizedTypes.forEach(sourceType => {
+                    if (sourceType === "system_derived") {
+                        statements.deleteDerivedDocumentTagByDocumentAndSource.run(documentId, sourceType);
+                    }
+                    else {
+                        statements.deleteDocumentTagByDocumentAndSource.run(documentId, sourceType);
+                    }
+                });
+                db.exec("COMMIT");
+            }
+            catch (error) {
+                db.exec("ROLLBACK");
+                throw error;
+            }
+        });
+    }
+    recomputeResolvedTags(entries, observedAt = new Date().toISOString(), documentIds = []) {
+        const normalizedDocumentIds = [...new Set([
+                ...documentIds,
+                ...entries.map(item => item.documentId),
+            ].map(item => item.trim()).filter(Boolean))];
+        if (normalizedDocumentIds.length === 0) {
+            return { updatedCount: 0, updatedDocumentIds: [] };
+        }
+        return this.withConnection((db, statements) => {
+            const tagCache = new Map(this.tagIdCache);
+            const selectCurrentDocumentTags = db.prepare(`
+        SELECT tag_id, confidence, source, source_ref, evidence, manual_override
+        FROM document_tags
+        WHERE document_id = ?
+        ORDER BY tag_id, source, COALESCE(source_ref, ''), COALESCE(evidence, '')
+      `);
+            const selectCurrentDerivedTags = db.prepare(`
+        SELECT tag_id, source, source_ref, rule_name, evidence
+        FROM derived_document_tags
+        WHERE document_id = ?
+        ORDER BY tag_id, source, COALESCE(source_ref, ''), rule_name, COALESCE(evidence, '')
+      `);
+            try {
+                db.exec("BEGIN IMMEDIATE");
+                const groupedByDocument = new Map();
+                entries.forEach(entry => {
+                    const current = groupedByDocument.get(entry.documentId) ?? [];
+                    current.push(entry);
+                    groupedByDocument.set(entry.documentId, current);
+                });
+                let updatedCount = 0;
+                const updatedDocumentIds = [];
+                for (const documentId of normalizedDocumentIds) {
+                    const documentEntries = groupedByDocument.get(documentId) ?? [];
+                    const nextDocumentTags = [];
+                    const nextDerivedTags = [];
+                    for (const entry of documentEntries) {
+                        const tagId = this.ensureTagInConnection(db, statements, tagCache, entry.tagPath, entry.sourceType);
+                        if (entry.sourceType === "system_derived") {
+                            nextDerivedTags.push({
+                                tag_id: tagId,
+                                source: entry.sourceType,
+                                source_ref: entry.sourceRef ?? null,
+                                rule_name: entry.sourceRef ?? "system_derived",
+                                evidence: entry.evidence ?? null,
+                            });
+                        }
+                        else {
+                            nextDocumentTags.push({
+                                tag_id: tagId,
+                                confidence: entry.confidence,
+                                source: entry.sourceType,
+                                source_ref: entry.sourceRef ?? null,
+                                evidence: entry.evidence ?? null,
+                                manual_override: entry.sourceType === "manual_document" ? 1 : 0,
+                            });
+                        }
+                    }
+                    nextDocumentTags.sort(compareCurrentResolvedDocumentTagRow);
+                    nextDerivedTags.sort(compareCurrentResolvedDerivedTagRow);
+                    const currentDocumentTags = selectCurrentDocumentTags.all(documentId);
+                    const currentDerivedTags = selectCurrentDerivedTags.all(documentId);
+                    if (areResolvedDocumentTagRowsEqual(currentDocumentTags, nextDocumentTags)
+                        && areResolvedDerivedTagRowsEqual(currentDerivedTags, nextDerivedTags)) {
+                        continue;
+                    }
+                    statements.deleteDocumentTags.run(documentId);
+                    statements.deleteDerivedDocumentTags.run(documentId);
+                    for (const nextDocumentTag of nextDocumentTags) {
+                        statements.upsertDocumentTag.run(makeStableId("doc_tag", `${documentId}:${nextDocumentTag.tag_id}`), documentId, nextDocumentTag.tag_id, nextDocumentTag.confidence, nextDocumentTag.source, nextDocumentTag.source_ref, nextDocumentTag.evidence, nextDocumentTag.manual_override, observedAt);
+                    }
+                    for (const nextDerivedTag of nextDerivedTags) {
+                        statements.upsertDerivedTag.run(makeStableId("derived_tag", `${documentId}:${nextDerivedTag.tag_id}`), documentId, nextDerivedTag.tag_id, nextDerivedTag.source, nextDerivedTag.source_ref, nextDerivedTag.rule_name, nextDerivedTag.evidence, observedAt, observedAt);
+                    }
+                    updatedCount += 1;
+                    updatedDocumentIds.push(documentId);
+                }
+                db.exec("COMMIT");
+                return { updatedCount, updatedDocumentIds };
+            }
+            catch (error) {
+                db.exec("ROLLBACK");
+                throw error;
+            }
+        });
+    }
+}
+function normalizeFileIdentityValue(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const normalized = value.trim();
+    return normalized ? normalized : null;
+}
+function buildDocumentContentHash(text) {
+    if (!text.trim()) {
+        return null;
+    }
+    return crypto.createHash("sha1").update(text).digest("hex");
+}
+function compareCurrentResolvedDocumentTagRow(left, right) {
+    return compareComparableTuples([
+        left.tag_id,
+        String(left.confidence),
+        left.source,
+        left.source_ref ?? "",
+        left.evidence ?? "",
+        String(left.manual_override),
+    ], [
+        right.tag_id,
+        String(right.confidence),
+        right.source,
+        right.source_ref ?? "",
+        right.evidence ?? "",
+        String(right.manual_override),
+    ]);
+}
+function compareCurrentResolvedDerivedTagRow(left, right) {
+    return compareComparableTuples([
+        left.tag_id,
+        left.source,
+        left.source_ref ?? "",
+        left.rule_name,
+        left.evidence ?? "",
+    ], [
+        right.tag_id,
+        right.source,
+        right.source_ref ?? "",
+        right.rule_name,
+        right.evidence ?? "",
+    ]);
+}
+function areResolvedDocumentTagRowsEqual(currentRows, nextRows) {
+    if (currentRows.length !== nextRows.length) {
+        return false;
+    }
+    return currentRows.every((row, index) => compareCurrentResolvedDocumentTagRow(row, nextRows[index]) === 0);
+}
+function areResolvedDerivedTagRowsEqual(currentRows, nextRows) {
+    if (currentRows.length !== nextRows.length) {
+        return false;
+    }
+    return currentRows.every((row, index) => compareCurrentResolvedDerivedTagRow(row, nextRows[index]) === 0);
+}
+function compareComparableTuples(left, right) {
+    const maxLength = Math.max(left.length, right.length);
+    for (let index = 0; index < maxLength; index += 1) {
+        const leftValue = left[index] ?? "";
+        const rightValue = right[index] ?? "";
+        if (leftValue === rightValue) {
+            continue;
+        }
+        return leftValue < rightValue ? -1 : 1;
+    }
+    return 0;
+}
+function doesSiblingPathStillExist(file, candidateRelativePath) {
+    const rootDir = resolveRootDirFromFile(file);
+    if (!rootDir) {
+        return true;
+    }
+    return fs.existsSync(path.join(rootDir, candidateRelativePath));
+}
+function resolveRootDirFromFile(file) {
+    const normalizedRelativePath = file.relativePath.split(path.sep).join("/");
+    if (!normalizedRelativePath) {
+        return path.dirname(file.fullPath);
+    }
+    const suffix = normalizedRelativePath.split("/").join(path.sep);
+    if (!file.fullPath.endsWith(suffix)) {
+        return path.dirname(file.fullPath);
+    }
+    const rootDir = file.fullPath.slice(0, file.fullPath.length - suffix.length);
+    return rootDir.replace(/[\\/]$/, "") || path.parse(file.fullPath).root || null;
+}
+function serializeManualFileBindingIdentity(target, tagId) {
+    return JSON.stringify({
+        inodeKey: target.inodeKey ?? null,
+        contentHash: target.contentHash ?? null,
+        size: target.size,
+        extension: target.extension,
+        tagId,
+    });
+}
+function buildIdentityContentKey(contentHash, size, extension) {
+    if (!contentHash) {
+        return null;
+    }
+    return `${contentHash}::${size}::${extension}`;
+}
+function buildIdentityDocumentIdsByInode(rows) {
+    const counts = new Map();
+    rows.forEach((row) => {
+        if (!row.inodeKey) {
+            return;
+        }
+        counts.set(row.inodeKey, (counts.get(row.inodeKey) ?? 0) + 1);
+    });
+    return counts;
+}
+function buildIdentityDocumentIdsByContent(rows) {
+    const counts = new Map();
+    rows.forEach((row) => {
+        const key = buildIdentityContentKey(row.contentHash, row.size, row.extension);
+        if (!key) {
+            return;
+        }
+        counts.set(key, (counts.get(key) ?? 0) + 1);
+    });
+    return counts;
+}
+function hasSameManualBindingIdentity(left, right) {
+    if (left.inodeKey && right.inodeKey) {
+        return left.inodeKey === right.inodeKey;
+    }
+    return buildIdentityContentKey(left.contentHash, left.size, left.extension)
+        === buildIdentityContentKey(right.contentHash, right.size, right.extension);
+}
+//# sourceMappingURL=catalog-write-repository.js.map