@jingyi0605/codingns 0.8.5 → 0.9.5

package/dist/server/modules/affairs-indexer/core/src/services/watch/watch-service.js

@@ -0,0 +1,227 @@
+import fs from "node:fs";
+import path from "node:path";
+import { AppError, APP_ERROR_CODES } from "../../../../contracts/src/index.js";
+import { loadRuntimeConfig } from "../../config/load-runtime-config.js";
+import { CatalogWriteRepository } from "../../repositories/catalog-write-repository.js";
+import { ExportBuilder } from "../export/export-builder.js";
+import { AllowedExtensionsDiffService } from "../indexer/allowed-extensions-diff-service.js";
+import { TextIndexer } from "../indexer/text-indexer.js";
+const WATCHER_READY_META_KEY = "watcher.ready_after_initial_export";
+function readJsonFile(filePath) {
+    if (!fs.existsSync(filePath)) {
+        return null;
+    }
+    try {
+        return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+    }
+    catch (_) {
+        return null;
+    }
+}
+function normalizeRelativePath(relativePath) {
+    return relativePath.split(path.sep).join("/");
+}
+function resolveWatchRoot(rootDir, targetPath) {
+    return targetPath ? path.resolve(rootDir, targetPath) : rootDir;
+}
+function isConfigPath(relativePath) {
+    return relativePath === ".ai-index/doc-semantic-index.config.json"
+        || relativePath === "doc-semantic-index.config.json"
+        || relativePath === ".doc-semantic-indexrc.json"
+        || relativePath === ".doc-semantic-index/config.json";
+}
+function isIgnoredWatchPath(relativePath) {
+    if (!relativePath) {
+        return false;
+    }
+    if (isConfigPath(relativePath)) {
+        return false;
+    }
+    return relativePath === ".ai-index" || relativePath.startsWith(".ai-index/");
+}
+/**
+ * 最小 watch 服务。
+ * 第二阶段补上 Dirty Scope 透传与静态导出构建。
+ */
+export class WatchService {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    async runCycleAsync(targetPath) {
+        const indexer = new TextIndexer(this.config);
+        const indexResult = await indexer.index(targetPath);
+        const exportResult = await new ExportBuilder(this.config).build({ dirtyScope: indexResult.dirtyScope });
+        return {
+            scopePath: targetPath,
+            kind: "index",
+            index: indexResult,
+            configApply: null,
+            export: {
+                metaShardCount: exportResult.metaShardCount,
+                detailShardCount: exportResult.detailShardCount,
+                tagShardCount: exportResult.tagShardCount,
+                exportedAt: exportResult.exportedAt,
+            },
+        };
+    }
+    async runConfigCycleAsync() {
+        const config = loadRuntimeConfig(this.config.rootDir, {
+            args: {
+                rootDir: this.config.rootDir,
+            },
+            env: process.env,
+        });
+        const result = await new AllowedExtensionsDiffService(config).applyIfNeeded();
+        return {
+            scopePath: ".ai-index/doc-semantic-index.config.json",
+            kind: "config",
+            index: result.indexResult,
+            configApply: result,
+            export: result.exportResult,
+        };
+    }
+    async run(options = {}) {
+        const debounceMs = typeof options.debounceMs === "number" && options.debounceMs >= 0
+            ? options.debounceMs
+            : this.config.watchDebounceMs;
+        const watchRoot = resolveWatchRoot(this.config.rootDir, options.targetPath);
+        const initialCycle = await this.runCycleAsync(options.targetPath);
+        if (!options.targetPath) {
+            new AllowedExtensionsDiffService(this.config).syncCurrentAsApplied();
+        }
+        if (options.once) {
+            return {
+                mode: "once",
+                watchRoot,
+                recursive: false,
+                debounceMs,
+                cycleCount: 1,
+                eventCount: 0,
+                lastEvent: null,
+                initialCycle,
+                cycles: [initialCycle],
+                stoppedBy: "once",
+            };
+        }
+        const writer = new CatalogWriteRepository(this.config.dbPath);
+        const manifest = readJsonFile(path.join(this.config.exportDir, "manifest.json"));
+        const indexedDocumentCount = writer.countActiveIndexedDocuments();
+        const exportedDocumentCount = Array.isArray(manifest?.detail_shards) ? manifest.detail_shards.length : 0;
+        const exportIsStale = exportedDocumentCount < indexedDocumentCount;
+        if (!options.targetPath && exportIsStale) {
+            const exportResult = await new ExportBuilder(this.config).build({ light: true });
+            writer.setSchemaMeta(WATCHER_READY_META_KEY, new Date().toISOString());
+            initialCycle.export = {
+                metaShardCount: exportResult.metaShardCount,
+                detailShardCount: exportResult.detailShardCount,
+                tagShardCount: exportResult.tagShardCount,
+                exportedAt: exportResult.exportedAt,
+            };
+        }
+        if (!fs.existsSync(watchRoot)) {
+            throw new AppError(`watch 目标路径不存在：${watchRoot}`, APP_ERROR_CODES.WATCH_PATH_NOT_FOUND, {
+                details: {
+                    watchRoot,
+                    targetPath: options.targetPath ?? null,
+                },
+            });
+        }
+        const recursive = true;
+        const cycles = [initialCycle];
+        let cycleCount = 1;
+        let eventCount = 0;
+        let lastEvent = null;
+        let stopped = false;
+        let timeoutId = null;
+        let debounceTimer = null;
+        let pendingScope;
+        return await new Promise((resolve, reject) => {
+            const finish = (stoppedBy) => {
+                if (stopped) {
+                    return;
+                }
+                stopped = true;
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                }
+                if (debounceTimer) {
+                    clearTimeout(debounceTimer);
+                }
+                watcher.close();
+                process.off("SIGINT", handleSignal);
+                process.off("SIGTERM", handleSignal);
+                resolve({
+                    mode: "watch",
+                    watchRoot,
+                    recursive,
+                    debounceMs,
+                    cycleCount,
+                    eventCount,
+                    lastEvent,
+                    initialCycle,
+                    cycles,
+                    stoppedBy,
+                });
+            };
+            const handleSignal = () => finish("signal");
+            const flush = async () => {
+                try {
+                    const cycle = pendingScope && isConfigPath(pendingScope)
+                        ? await this.runConfigCycleAsync()
+                        : await this.runCycleAsync(pendingScope ?? options.targetPath);
+                    cycles.push(cycle);
+                    cycleCount += 1;
+                    pendingScope = undefined;
+                }
+                catch (error) {
+                    reject(error);
+                }
+            };
+            const scheduleFlush = () => {
+                if (debounceTimer) {
+                    clearTimeout(debounceTimer);
+                }
+                debounceTimer = setTimeout(() => {
+                    void flush();
+                }, debounceMs);
+            };
+            const watcher = fs.watch(watchRoot, { recursive }, (eventType, filename) => {
+                eventCount += 1;
+                const resolvedRelativePath = filename
+                    ? normalizeRelativePath(path.relative(this.config.rootDir, path.join(watchRoot, filename.toString())))
+                    : null;
+                lastEvent = {
+                    eventType,
+                    relativePath: resolvedRelativePath,
+                };
+                if (isIgnoredWatchPath(resolvedRelativePath)) {
+                    return;
+                }
+                if (!filename) {
+                    pendingScope = options.targetPath;
+                    scheduleFlush();
+                    return;
+                }
+                const rawPath = path.join(watchRoot, filename.toString());
+                const relativePath = normalizeRelativePath(path.relative(this.config.rootDir, rawPath));
+                if (isConfigPath(relativePath)) {
+                    pendingScope = relativePath;
+                    scheduleFlush();
+                    return;
+                }
+                const scopeAbsolutePath = eventType === "rename" ? path.dirname(rawPath) : rawPath;
+                const relativeScope = normalizeRelativePath(path.relative(this.config.rootDir, scopeAbsolutePath));
+                pendingScope = !relativeScope || relativeScope === "." ? undefined : relativeScope;
+                scheduleFlush();
+            });
+            watcher.on("error", error => reject(error));
+            process.on("SIGINT", handleSignal);
+            process.on("SIGTERM", handleSignal);
+            if (typeof options.durationMs === "number" && options.durationMs > 0) {
+                timeoutId = setTimeout(() => finish("timeout"), options.durationMs);
+            }
+        });
+    }
+}
+//# sourceMappingURL=watch-service.js.map

package/dist/server/modules/affairs-indexer/core/src/services/watch/watch-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch-service.js","sourceRoot":"","sources":["../../../../../../../../src/modules/affairs-indexer/core/src/services/watch/watch-service.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/affairs-indexer/core/src/sqlite/catalog-schema.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 当前 Node 版最小 catalog schema。
+ * 以 SQLite 为唯一真相源，保持 schema 可迁移、可追踪。
+ */
+export declare const CATALOG_SCHEMA_SQL = "\nCREATE TABLE IF NOT EXISTS schema_meta (\n  key TEXT PRIMARY KEY,\n  value TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS migration_history (\n  id TEXT PRIMARY KEY,\n  version INTEGER NOT NULL,\n  name TEXT NOT NULL,\n  applied_at TEXT NOT NULL,\n  checksum TEXT,\n  status TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS files (\n  id TEXT PRIMARY KEY,\n  path TEXT UNIQUE NOT NULL,\n  dir_path TEXT NOT NULL,\n  name TEXT NOT NULL,\n  extension TEXT NOT NULL,\n  size INTEGER NOT NULL,\n  mtime TEXT NOT NULL,\n  ctime TEXT,\n  inode_key TEXT,\n  content_hash TEXT,\n  status TEXT NOT NULL,\n  last_seen_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS documents (\n  id TEXT PRIMARY KEY,\n  file_id TEXT UNIQUE NOT NULL,\n  title TEXT,\n  summary TEXT,\n  language TEXT,\n  parse_status TEXT NOT NULL,\n  parse_error TEXT,\n  index_status TEXT NOT NULL,\n  chunk_count INTEGER NOT NULL,\n  last_indexed_at TEXT,\n  FOREIGN KEY(file_id) REFERENCES files(id)\n);\n\nCREATE TABLE IF NOT EXISTS chunks (\n  id TEXT PRIMARY KEY,\n  document_id TEXT NOT NULL,\n  chunk_index INTEGER NOT NULL,\n  content TEXT NOT NULL,\n  content_hash TEXT,\n  page_no INTEGER,\n  sheet_name TEXT,\n  heading_path TEXT,\n  token_count INTEGER,\n  vector_point_id TEXT,\n  FOREIGN KEY(document_id) REFERENCES documents(id)\n);\n\nCREATE TABLE IF NOT EXISTS tags (\n  id TEXT PRIMARY KEY,\n  root_type TEXT NOT NULL,\n  path TEXT UNIQUE NOT NULL,\n  name TEXT NOT NULL,\n  parent_id TEXT,\n  canonical_name TEXT NOT NULL,\n  description TEXT,\n  status TEXT NOT NULL,\n  created_by TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  disabled_at TEXT\n);\n\nCREATE TABLE IF NOT EXISTS tag_aliases (\n  id TEXT PRIMARY KEY,\n  tag_id TEXT NOT NULL,\n  alias TEXT NOT NULL,\n  alias_type TEXT NOT NULL,\n  confidence REAL NOT NULL,\n  updated_at TEXT NOT NULL,\n  FOREIGN KEY(tag_id) REFERENCES tags(id)\n);\n\nCREATE TABLE IF NOT EXISTS document_tags (\n  id TEXT PRIMARY KEY,\n  document_id TEXT NOT NULL,\n  tag_id TEXT NOT NULL,\n  confidence REAL NOT NULL,\n  source TEXT NOT NULL,\n  source_ref TEXT,\n  evidence TEXT,\n  manual_override INTEGER NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(document_id, tag_id),\n  FOREIGN KEY(document_id) REFERENCES documents(id),\n  FOREIGN KEY(tag_id) REFERENCES tags(id)\n);\n\nCREATE TABLE IF NOT EXISTS derived_document_tags (\n  id TEXT PRIMARY KEY,\n  document_id TEXT NOT NULL,\n  tag_id TEXT NOT NULL,\n  source TEXT NOT NULL,\n  source_ref TEXT,\n  rule_name TEXT NOT NULL,\n  evidence TEXT,\n  computed_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  expires_at TEXT,\n  FOREIGN KEY(document_id) REFERENCES documents(id),\n  FOREIGN KEY(tag_id) REFERENCES tags(id)\n);\n\nCREATE TABLE IF NOT EXISTS tag_rules (\n  id TEXT PRIMARY KEY,\n  tag_id TEXT NOT NULL,\n  enabled INTEGER NOT NULL,\n  rule_type TEXT NOT NULL,\n  scope_json TEXT NOT NULL,\n  matcher_json TEXT NOT NULL,\n  min_score REAL,\n  priority INTEGER NOT NULL,\n  source TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  FOREIGN KEY(tag_id) REFERENCES tags(id)\n);\n\nCREATE TABLE IF NOT EXISTS manual_document_tag_bindings (\n  id TEXT PRIMARY KEY,\n  document_id TEXT NOT NULL,\n  tag_id TEXT NOT NULL,\n  source TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(document_id, tag_id),\n  FOREIGN KEY(document_id) REFERENCES documents(id),\n  FOREIGN KEY(tag_id) REFERENCES tags(id)\n);\n\nCREATE TABLE IF NOT EXISTS manual_file_tag_bindings (\n  id TEXT PRIMARY KEY,\n  inode_key TEXT,\n  content_hash TEXT,\n  file_size INTEGER NOT NULL,\n  extension TEXT NOT NULL,\n  tag_id TEXT NOT NULL,\n  source TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  FOREIGN KEY(tag_id) REFERENCES tags(id)\n);\n\nCREATE TABLE IF NOT EXISTS folder_tag_bindings (\n  id TEXT PRIMARY KEY,\n  folder_path TEXT NOT NULL,\n  tag_id TEXT NOT NULL,\n  apply_mode TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  UNIQUE(folder_path, tag_id, apply_mode),\n  FOREIGN KEY(tag_id) REFERENCES tags(id)\n);\n\nCREATE TABLE IF NOT EXISTS tag_recommendation_batches (\n  id TEXT PRIMARY KEY,\n  status TEXT NOT NULL,\n  summary TEXT,\n  evidence_snapshot_json TEXT,\n  generated_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS tag_recommendation_items (\n  id TEXT PRIMARY KEY,\n  batch_id TEXT NOT NULL,\n  proposed_path TEXT NOT NULL,\n  proposed_name TEXT NOT NULL,\n  proposed_parent_path TEXT,\n  document_count INTEGER NOT NULL,\n  evidence_json TEXT NOT NULL,\n  selected_by_default INTEGER NOT NULL,\n  status TEXT NOT NULL,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL,\n  FOREIGN KEY(batch_id) REFERENCES tag_recommendation_batches(id)\n);\n\nCREATE TABLE IF NOT EXISTS reindex_jobs (\n  id TEXT PRIMARY KEY,\n  job_type TEXT NOT NULL,\n  target_path TEXT,\n  status TEXT NOT NULL,\n  priority INTEGER NOT NULL,\n  error_message TEXT,\n  created_at TEXT NOT NULL,\n  updated_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS watch_events (\n  id TEXT PRIMARY KEY,\n  event_type TEXT NOT NULL,\n  path TEXT NOT NULL,\n  created_at TEXT NOT NULL\n);\n\nCREATE TABLE IF NOT EXISTS parser_skip_catalog (\n  skip_key TEXT PRIMARY KEY,\n  adapter TEXT NOT NULL,\n  reason_code TEXT NOT NULL,\n  extension TEXT NOT NULL,\n  sample_paths_json TEXT NOT NULL,\n  sample_count INTEGER NOT NULL,\n  total_count INTEGER NOT NULL,\n  last_message TEXT,\n  first_seen_at TEXT NOT NULL,\n  last_seen_at TEXT NOT NULL,\n  last_run_at TEXT NOT NULL\n);\n\nCREATE INDEX IF NOT EXISTS idx_files_hash ON files(content_hash);\nCREATE INDEX IF NOT EXISTS idx_files_inode_key ON files(inode_key);\nCREATE INDEX IF NOT EXISTS idx_chunks_document ON chunks(document_id, chunk_index);\nCREATE INDEX IF NOT EXISTS idx_tags_path ON tags(path);\nCREATE INDEX IF NOT EXISTS idx_document_tags_document ON document_tags(document_id);\nCREATE INDEX IF NOT EXISTS idx_document_tags_source ON document_tags(document_id, source);\nCREATE INDEX IF NOT EXISTS idx_derived_document_tags_document ON derived_document_tags(document_id);\nCREATE UNIQUE INDEX IF NOT EXISTS idx_derived_document_tags_pair ON derived_document_tags(document_id, tag_id);\nCREATE INDEX IF NOT EXISTS idx_tag_aliases_alias ON tag_aliases(alias);\nCREATE INDEX IF NOT EXISTS idx_tag_rules_tag ON tag_rules(tag_id, enabled, priority);\nCREATE INDEX IF NOT EXISTS idx_manual_document_tag_bindings_document ON manual_document_tag_bindings(document_id);\nCREATE INDEX IF NOT EXISTS idx_manual_file_tag_bindings_inode ON manual_file_tag_bindings(inode_key);\nCREATE INDEX IF NOT EXISTS idx_manual_file_tag_bindings_content ON manual_file_tag_bindings(content_hash, file_size, extension);\nCREATE INDEX IF NOT EXISTS idx_manual_file_tag_bindings_tag ON manual_file_tag_bindings(tag_id);\nCREATE INDEX IF NOT EXISTS idx_folder_tag_bindings_folder ON folder_tag_bindings(folder_path);\nCREATE INDEX IF NOT EXISTS idx_tag_recommendation_items_batch ON tag_recommendation_items(batch_id, status);\nCREATE INDEX IF NOT EXISTS idx_reindex_jobs_status ON reindex_jobs(status, priority, created_at);\nCREATE INDEX IF NOT EXISTS idx_parser_skip_catalog_reason ON parser_skip_catalog(reason_code, extension, last_run_at);\n";

package/dist/server/modules/affairs-indexer/core/src/sqlite/catalog-schema.js

@@ -0,0 +1,245 @@
+/**
+ * 当前 Node 版最小 catalog schema。
+ * 以 SQLite 为唯一真相源，保持 schema 可迁移、可追踪。
+ */
+export const CATALOG_SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS schema_meta (
+  key TEXT PRIMARY KEY,
+  value TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS migration_history (
+  id TEXT PRIMARY KEY,
+  version INTEGER NOT NULL,
+  name TEXT NOT NULL,
+  applied_at TEXT NOT NULL,
+  checksum TEXT,
+  status TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS files (
+  id TEXT PRIMARY KEY,
+  path TEXT UNIQUE NOT NULL,
+  dir_path TEXT NOT NULL,
+  name TEXT NOT NULL,
+  extension TEXT NOT NULL,
+  size INTEGER NOT NULL,
+  mtime TEXT NOT NULL,
+  ctime TEXT,
+  inode_key TEXT,
+  content_hash TEXT,
+  status TEXT NOT NULL,
+  last_seen_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS documents (
+  id TEXT PRIMARY KEY,
+  file_id TEXT UNIQUE NOT NULL,
+  title TEXT,
+  summary TEXT,
+  language TEXT,
+  parse_status TEXT NOT NULL,
+  parse_error TEXT,
+  index_status TEXT NOT NULL,
+  chunk_count INTEGER NOT NULL,
+  last_indexed_at TEXT,
+  FOREIGN KEY(file_id) REFERENCES files(id)
+);
+
+CREATE TABLE IF NOT EXISTS chunks (
+  id TEXT PRIMARY KEY,
+  document_id TEXT NOT NULL,
+  chunk_index INTEGER NOT NULL,
+  content TEXT NOT NULL,
+  content_hash TEXT,
+  page_no INTEGER,
+  sheet_name TEXT,
+  heading_path TEXT,
+  token_count INTEGER,
+  vector_point_id TEXT,
+  FOREIGN KEY(document_id) REFERENCES documents(id)
+);
+
+CREATE TABLE IF NOT EXISTS tags (
+  id TEXT PRIMARY KEY,
+  root_type TEXT NOT NULL,
+  path TEXT UNIQUE NOT NULL,
+  name TEXT NOT NULL,
+  parent_id TEXT,
+  canonical_name TEXT NOT NULL,
+  description TEXT,
+  status TEXT NOT NULL,
+  created_by TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  disabled_at TEXT
+);
+
+CREATE TABLE IF NOT EXISTS tag_aliases (
+  id TEXT PRIMARY KEY,
+  tag_id TEXT NOT NULL,
+  alias TEXT NOT NULL,
+  alias_type TEXT NOT NULL,
+  confidence REAL NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY(tag_id) REFERENCES tags(id)
+);
+
+CREATE TABLE IF NOT EXISTS document_tags (
+  id TEXT PRIMARY KEY,
+  document_id TEXT NOT NULL,
+  tag_id TEXT NOT NULL,
+  confidence REAL NOT NULL,
+  source TEXT NOT NULL,
+  source_ref TEXT,
+  evidence TEXT,
+  manual_override INTEGER NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE(document_id, tag_id),
+  FOREIGN KEY(document_id) REFERENCES documents(id),
+  FOREIGN KEY(tag_id) REFERENCES tags(id)
+);
+
+CREATE TABLE IF NOT EXISTS derived_document_tags (
+  id TEXT PRIMARY KEY,
+  document_id TEXT NOT NULL,
+  tag_id TEXT NOT NULL,
+  source TEXT NOT NULL,
+  source_ref TEXT,
+  rule_name TEXT NOT NULL,
+  evidence TEXT,
+  computed_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  expires_at TEXT,
+  FOREIGN KEY(document_id) REFERENCES documents(id),
+  FOREIGN KEY(tag_id) REFERENCES tags(id)
+);
+
+CREATE TABLE IF NOT EXISTS tag_rules (
+  id TEXT PRIMARY KEY,
+  tag_id TEXT NOT NULL,
+  enabled INTEGER NOT NULL,
+  rule_type TEXT NOT NULL,
+  scope_json TEXT NOT NULL,
+  matcher_json TEXT NOT NULL,
+  min_score REAL,
+  priority INTEGER NOT NULL,
+  source TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY(tag_id) REFERENCES tags(id)
+);
+
+CREATE TABLE IF NOT EXISTS manual_document_tag_bindings (
+  id TEXT PRIMARY KEY,
+  document_id TEXT NOT NULL,
+  tag_id TEXT NOT NULL,
+  source TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE(document_id, tag_id),
+  FOREIGN KEY(document_id) REFERENCES documents(id),
+  FOREIGN KEY(tag_id) REFERENCES tags(id)
+);
+
+CREATE TABLE IF NOT EXISTS manual_file_tag_bindings (
+  id TEXT PRIMARY KEY,
+  inode_key TEXT,
+  content_hash TEXT,
+  file_size INTEGER NOT NULL,
+  extension TEXT NOT NULL,
+  tag_id TEXT NOT NULL,
+  source TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY(tag_id) REFERENCES tags(id)
+);
+
+CREATE TABLE IF NOT EXISTS folder_tag_bindings (
+  id TEXT PRIMARY KEY,
+  folder_path TEXT NOT NULL,
+  tag_id TEXT NOT NULL,
+  apply_mode TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  UNIQUE(folder_path, tag_id, apply_mode),
+  FOREIGN KEY(tag_id) REFERENCES tags(id)
+);
+
+CREATE TABLE IF NOT EXISTS tag_recommendation_batches (
+  id TEXT PRIMARY KEY,
+  status TEXT NOT NULL,
+  summary TEXT,
+  evidence_snapshot_json TEXT,
+  generated_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS tag_recommendation_items (
+  id TEXT PRIMARY KEY,
+  batch_id TEXT NOT NULL,
+  proposed_path TEXT NOT NULL,
+  proposed_name TEXT NOT NULL,
+  proposed_parent_path TEXT,
+  document_count INTEGER NOT NULL,
+  evidence_json TEXT NOT NULL,
+  selected_by_default INTEGER NOT NULL,
+  status TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  FOREIGN KEY(batch_id) REFERENCES tag_recommendation_batches(id)
+);
+
+CREATE TABLE IF NOT EXISTS reindex_jobs (
+  id TEXT PRIMARY KEY,
+  job_type TEXT NOT NULL,
+  target_path TEXT,
+  status TEXT NOT NULL,
+  priority INTEGER NOT NULL,
+  error_message TEXT,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS watch_events (
+  id TEXT PRIMARY KEY,
+  event_type TEXT NOT NULL,
+  path TEXT NOT NULL,
+  created_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS parser_skip_catalog (
+  skip_key TEXT PRIMARY KEY,
+  adapter TEXT NOT NULL,
+  reason_code TEXT NOT NULL,
+  extension TEXT NOT NULL,
+  sample_paths_json TEXT NOT NULL,
+  sample_count INTEGER NOT NULL,
+  total_count INTEGER NOT NULL,
+  last_message TEXT,
+  first_seen_at TEXT NOT NULL,
+  last_seen_at TEXT NOT NULL,
+  last_run_at TEXT NOT NULL
+);
+
+CREATE INDEX IF NOT EXISTS idx_files_hash ON files(content_hash);
+CREATE INDEX IF NOT EXISTS idx_files_inode_key ON files(inode_key);
+CREATE INDEX IF NOT EXISTS idx_chunks_document ON chunks(document_id, chunk_index);
+CREATE INDEX IF NOT EXISTS idx_tags_path ON tags(path);
+CREATE INDEX IF NOT EXISTS idx_document_tags_document ON document_tags(document_id);
+CREATE INDEX IF NOT EXISTS idx_document_tags_source ON document_tags(document_id, source);
+CREATE INDEX IF NOT EXISTS idx_derived_document_tags_document ON derived_document_tags(document_id);
+CREATE UNIQUE INDEX IF NOT EXISTS idx_derived_document_tags_pair ON derived_document_tags(document_id, tag_id);
+CREATE INDEX IF NOT EXISTS idx_tag_aliases_alias ON tag_aliases(alias);
+CREATE INDEX IF NOT EXISTS idx_tag_rules_tag ON tag_rules(tag_id, enabled, priority);
+CREATE INDEX IF NOT EXISTS idx_manual_document_tag_bindings_document ON manual_document_tag_bindings(document_id);
+CREATE INDEX IF NOT EXISTS idx_manual_file_tag_bindings_inode ON manual_file_tag_bindings(inode_key);
+CREATE INDEX IF NOT EXISTS idx_manual_file_tag_bindings_content ON manual_file_tag_bindings(content_hash, file_size, extension);
+CREATE INDEX IF NOT EXISTS idx_manual_file_tag_bindings_tag ON manual_file_tag_bindings(tag_id);
+CREATE INDEX IF NOT EXISTS idx_folder_tag_bindings_folder ON folder_tag_bindings(folder_path);
+CREATE INDEX IF NOT EXISTS idx_tag_recommendation_items_batch ON tag_recommendation_items(batch_id, status);
+CREATE INDEX IF NOT EXISTS idx_reindex_jobs_status ON reindex_jobs(status, priority, created_at);
+CREATE INDEX IF NOT EXISTS idx_parser_skip_catalog_reason ON parser_skip_catalog(reason_code, extension, last_run_at);
+`;
+//# sourceMappingURL=catalog-schema.js.map

package/dist/server/modules/affairs-indexer/core/src/sqlite/catalog-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-schema.js","sourceRoot":"","sources":["../../../../../../../src/modules/affairs-indexer/core/src/sqlite/catalog-schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+OjC,CAAC"}

package/dist/server/modules/affairs-indexer/core/src/sqlite/detect-catalog-schema.d.ts

@@ -0,0 +1,14 @@
+export type CatalogSchemaMode = "absent" | "empty" | "legacy_unsupported" | "node_v1" | "node_v2" | "node_v3" | "unknown";
+export interface CatalogSchemaReport {
+    mode: CatalogSchemaMode;
+    dbPath: string;
+    tableCount: number;
+    tableNames: string[];
+    schemaVersion: number | null;
+    managedBy: string | null;
+}
+/**
+ * 检测当前 catalog.db 的 schema 状态。
+ * 这里保留对旧库形态的识别，但不再保留 Python 运行时或并行期依赖。
+ */
+export declare function detectCatalogSchema(dbPath: string): Promise<CatalogSchemaReport>;

package/dist/server/modules/affairs-indexer/core/src/sqlite/detect-catalog-schema.js

@@ -0,0 +1,87 @@
+import fs from "node:fs";
+import { openDatabase } from "./open-database.js";
+/**
+ * 检测当前 catalog.db 的 schema 状态。
+ * 这里保留对旧库形态的识别，但不再保留 Python 运行时或并行期依赖。
+ */
+export async function detectCatalogSchema(dbPath) {
+    if (!fs.existsSync(dbPath)) {
+        return {
+            mode: "absent",
+            dbPath,
+            tableCount: 0,
+            tableNames: [],
+            schemaVersion: null,
+            managedBy: null,
+        };
+    }
+    const db = openDatabase(dbPath);
+    try {
+        const tables = db.prepare(`
+      SELECT name
+      FROM sqlite_master
+      WHERE type = 'table' AND name NOT LIKE 'sqlite_%'
+      ORDER BY name
+    `).all();
+        const tableNames = tables.map(item => item.name);
+        const tableCount = tableNames.length;
+        if (tableCount === 0) {
+            return {
+                mode: "empty",
+                dbPath,
+                tableCount,
+                tableNames,
+                schemaVersion: null,
+                managedBy: null,
+            };
+        }
+        const hasSchemaMeta = tableNames.includes("schema_meta");
+        const hasLegacyCoreTables = ["files", "documents", "chunks", "tags"].every(name => tableNames.includes(name));
+        if (hasSchemaMeta) {
+            const rows = db.prepare(`SELECT key, value FROM schema_meta WHERE key IN ('schema_version', 'managed_by')`).all();
+            const kv = new Map(rows.map(item => [item.key, item.value]));
+            const rawVersion = kv.get("schema_version");
+            const schemaVersion = rawVersion ? Number(rawVersion) : null;
+            const managedBy = kv.get("managed_by") ?? null;
+            const mode = managedBy === "node"
+                ? schemaVersion === 1
+                    ? "node_v1"
+                    : schemaVersion === 2
+                        ? "node_v2"
+                        : schemaVersion === 3
+                            ? "node_v3"
+                            : "unknown"
+                : "unknown";
+            return {
+                mode,
+                dbPath,
+                tableCount,
+                tableNames,
+                schemaVersion: Number.isFinite(schemaVersion) ? schemaVersion : null,
+                managedBy,
+            };
+        }
+        if (hasLegacyCoreTables) {
+            return {
+                mode: "legacy_unsupported",
+                dbPath,
+                tableCount,
+                tableNames,
+                schemaVersion: null,
+                managedBy: null,
+            };
+        }
+        return {
+            mode: "unknown",
+            dbPath,
+            tableCount,
+            tableNames,
+            schemaVersion: null,
+            managedBy: null,
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=detect-catalog-schema.js.map

package/dist/server/modules/affairs-indexer/core/src/sqlite/detect-catalog-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-catalog-schema.js","sourceRoot":"","sources":["../../../../../../../src/modules/affairs-indexer/core/src/sqlite/detect-catalog-schema.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/affairs-indexer/core/src/sqlite/init-catalog.d.ts

@@ -0,0 +1,13 @@
+import type { RuntimeConfig } from "../../../contracts/src/index.js";
+export interface InitCatalogResult {
+    dbPath: string;
+    indexDir: string;
+    schemaVersion: number;
+    createdAt: string;
+    appliedMigrations: string[];
+}
+/**
+ * 初始化最小 catalog schema。
+ * 第二阶段改为通过 migration runner 执行，避免后续 schema 升级继续硬编码在 init 里。
+ */
+export declare function initCatalog(config: RuntimeConfig): InitCatalogResult;

package/dist/server/modules/affairs-indexer/core/src/sqlite/init-catalog.js

@@ -0,0 +1,16 @@
+import { runCatalogMigrations } from "./migration-runner.js";
+/**
+ * 初始化最小 catalog schema。
+ * 第二阶段改为通过 migration runner 执行，避免后续 schema 升级继续硬编码在 init 里。
+ */
+export function initCatalog(config) {
+    const result = runCatalogMigrations(config);
+    return {
+        dbPath: result.dbPath,
+        indexDir: config.indexDir,
+        schemaVersion: result.schemaVersion,
+        createdAt: result.executedAt,
+        appliedMigrations: result.appliedMigrations,
+    };
+}
+//# sourceMappingURL=init-catalog.js.map

package/dist/server/modules/affairs-indexer/core/src/sqlite/init-catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-catalog.js","sourceRoot":"","sources":["../../../../../../../src/modules/affairs-indexer/core/src/sqlite/init-catalog.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAU7D;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAqB;IAC/C,MAAM,MAAM,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAC5C,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,SAAS,EAAE,MAAM,CAAC,UAAU;QAC5B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;KAC5C,CAAC;AACJ,CAAC"}