@mrc2204/agent-smart-memo 5.1.16 → 5.1.18

package/dist/db/slot-db.js

@@ -6,17 +6,17 @@
  * Keys use dot-notation: "profile.name", "preferences.theme", etc.
  * Values are stored as JSON strings.
  */
-import { DatabaseSync } from "node:sqlite";
 import { randomUUID } from "node:crypto";
+import { existsSync, mkdirSync } from "node:fs";
 import { join } from "node:path";
-import { mkdirSync, existsSync } from "node:fs";
+import { DatabaseSync } from "node:sqlite";
+import { populateUniversalCodeGraphForFile } from "../core/graph/code-graph-populator.js";
+import { buildSymbolId } from "../core/ingest/ids.js";
 import { buildChunkArtifacts } from "../core/ingest/ingest-pipeline.js";
 import { extractSemanticBlocks } from "../core/ingest/semantic-block-extractor.js";
-import { buildSymbolId } from "../core/ingest/ids.js";
-import { populateUniversalCodeGraphForFile } from "../core/graph/code-graph-populator.js";
-import { GraphDB } from "./graph-db.js";
 import { getSlotTTL } from "../shared/memory-config.js";
-import { resolveLegacyStateDirInput, resolveSlotDbDir } from "../shared/slotdb-path.js";
+import { resolveLegacyStateDirInput, resolveSlotDbDir, } from "../shared/slotdb-path.js";
+import { GraphDB } from "./graph-db.js";
 // Re-export GraphDB types
 export { GraphDB };
 // ============================================================================
@@ -32,7 +32,10 @@ export class SlotDB {
         // Priority resolver for new config/env flow.
         // If explicit slotDbDir option is provided, it is treated as already-resolved target dir.
         if (options?.slotDbDir) {
-            this.slotDbDir = resolveSlotDbDir({ slotDbDir: options.slotDbDir, stateDir: stateDirOrSlotDbDir });
+            this.slotDbDir = resolveSlotDbDir({
+                slotDbDir: options.slotDbDir,
+                stateDir: stateDirOrSlotDbDir,
+            });
         }
         else {
             // Backward compatibility for legacy constructor callsites that pass OPENCLAW_STATE_DIR.
@@ -330,7 +333,9 @@ export class SlotDB {
                 confidence,
                 version: newVersion,
                 updated_at: now,
-                expires_at: input.expires_at !== undefined ? input.expires_at : existing.expires_at,
+                expires_at: input.expires_at !== undefined
+                    ? input.expires_at
+                    : existing.expires_at,
             };
         }
         // Insert new slot
@@ -452,8 +457,10 @@ export class SlotDB {
         const normalizedRepoRoot = this.normalizeRepoRoot(input.repo_root);
         const normalizedRepoRemote = this.normalizeRepoRemote(input.repo_remote);
         const existingAlias = this.getProjectByAlias(scopeUserId, scopeAgentId, projectAlias);
-        if (existingAlias && existingAlias.project.project_id !== projectId && !input.allow_alias_update) {
-            throw new Error(`project_alias \"${projectAlias}\" is already mapped to another project_id`);
+        if (existingAlias &&
+            existingAlias.project.project_id !== projectId &&
+            !input.allow_alias_update) {
+            throw new Error(`project_alias "${projectAlias}" is already mapped to another project_id`);
         }
         let targetProjectId = projectId;
         const existingByRepoRoot = input.reuse_existing_repo_root && normalizedRepoRoot
@@ -532,7 +539,9 @@ export class SlotDB {
                 scope_agent_id: String(row.scope_agent_id),
                 project_name: String(row.project_name),
                 repo_root: row.repo_root ? String(row.repo_root) : null,
-                repo_remote_primary: row.repo_remote_primary ? String(row.repo_remote_primary) : null,
+                repo_remote_primary: row.repo_remote_primary
+                    ? String(row.repo_remote_primary)
+                    : null,
                 active_version: row.active_version ? String(row.active_version) : null,
                 lifecycle_status: String(row.lifecycle_status),
                 created_at: String(row.created_at),
@@ -652,18 +661,26 @@ export class SlotDB {
         const files = Number(fileCountStmt.get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
         const chunks = Number(chunkCountStmt.get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
         const symbols = Number(symbolCountStmt.get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
-        this.db.prepare(`UPDATE file_index_state
+        this.db
+            .prepare(`UPDATE file_index_state
        SET index_state = 'stale', active = 0, tombstone_at = ?, indexed_at = ?
-       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND active = 1`).run(now, now, scopeUserId, scopeAgentId, projectId);
-        this.db.prepare(`UPDATE chunk_registry
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND active = 1`)
+            .run(now, now, scopeUserId, scopeAgentId, projectId);
+        this.db
+            .prepare(`UPDATE chunk_registry
        SET index_state = 'stale', active = 0, tombstone_at = ?, indexed_at = ?
-       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND active = 1`).run(now, now, scopeUserId, scopeAgentId, projectId);
-        this.db.prepare(`UPDATE symbol_registry
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND active = 1`)
+            .run(now, now, scopeUserId, scopeAgentId, projectId);
+        this.db
+            .prepare(`UPDATE symbol_registry
        SET index_state = 'stale', active = 0, tombstone_at = ?, indexed_at = ?
-       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND active = 1`).run(now, now, scopeUserId, scopeAgentId, projectId);
-        this.db.prepare(`UPDATE projects
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND active = 1`)
+            .run(now, now, scopeUserId, scopeAgentId, projectId);
+        this.db
+            .prepare(`UPDATE projects
        SET lifecycle_status = 'deindexed', updated_at = ?
-       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(now, scopeUserId, scopeAgentId, projectId);
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+            .run(now, scopeUserId, scopeAgentId, projectId);
         this.insertIndexRun(scopeUserId, scopeAgentId, {
             run_id: randomUUID(),
             project_id: projectId,
@@ -703,17 +720,27 @@ export class SlotDB {
             });
         }
         const now = new Date().toISOString();
-        const aliasesRemoved = Number(this.db.prepare(`SELECT COUNT(*) as cnt FROM project_aliases
-       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
-        const trackerMappingsRemoved = Number(this.db.prepare(`SELECT COUNT(*) as cnt FROM project_tracker_mappings
-       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
-        this.db.prepare(`DELETE FROM project_aliases
-       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(scopeUserId, scopeAgentId, projectId);
-        this.db.prepare(`DELETE FROM project_tracker_mappings
-       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(scopeUserId, scopeAgentId, projectId);
-        this.db.prepare(`UPDATE projects
+        const aliasesRemoved = Number(this.db
+            .prepare(`SELECT COUNT(*) as cnt FROM project_aliases
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+            .get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
+        const trackerMappingsRemoved = Number(this.db
+            .prepare(`SELECT COUNT(*) as cnt FROM project_tracker_mappings
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+            .get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
+        this.db
+            .prepare(`DELETE FROM project_aliases
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+            .run(scopeUserId, scopeAgentId, projectId);
+        this.db
+            .prepare(`DELETE FROM project_tracker_mappings
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+            .run(scopeUserId, scopeAgentId, projectId);
+        this.db
+            .prepare(`UPDATE projects
        SET lifecycle_status = 'detached', repo_root = NULL, repo_remote_primary = NULL, active_version = NULL, updated_at = ?
-       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(now, scopeUserId, scopeAgentId, projectId);
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+            .run(now, scopeUserId, scopeAgentId, projectId);
         return {
             project_id: projectId,
             lifecycle_status: "detached",
@@ -758,17 +785,27 @@ export class SlotDB {
             deindexedFirst = true;
         }
         const now = new Date().toISOString();
-        const aliasesRemoved = Number(this.db.prepare(`SELECT COUNT(*) as cnt FROM project_aliases
-       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
-        const trackerMappingsRemoved = Number(this.db.prepare(`SELECT COUNT(*) as cnt FROM project_tracker_mappings
-       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
-        this.db.prepare(`DELETE FROM project_aliases
-       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(scopeUserId, scopeAgentId, projectId);
-        this.db.prepare(`DELETE FROM project_tracker_mappings
-       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(scopeUserId, scopeAgentId, projectId);
-        this.db.prepare(`UPDATE projects
+        const aliasesRemoved = Number(this.db
+            .prepare(`SELECT COUNT(*) as cnt FROM project_aliases
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+            .get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
+        const trackerMappingsRemoved = Number(this.db
+            .prepare(`SELECT COUNT(*) as cnt FROM project_tracker_mappings
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+            .get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
+        this.db
+            .prepare(`DELETE FROM project_aliases
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+            .run(scopeUserId, scopeAgentId, projectId);
+        this.db
+            .prepare(`DELETE FROM project_tracker_mappings
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+            .run(scopeUserId, scopeAgentId, projectId);
+        this.db
+            .prepare(`UPDATE projects
        SET lifecycle_status = 'disabled', repo_root = NULL, repo_remote_primary = NULL, active_version = NULL, updated_at = ?
-       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(now, scopeUserId, scopeAgentId, projectId);
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+            .run(now, scopeUserId, scopeAgentId, projectId);
         this.upsertProjectRegistrationState(scopeUserId, scopeAgentId, {
             project_id: projectId,
             registration_status: "draft",
@@ -807,8 +844,10 @@ export class SlotDB {
         if (!project) {
             throw new Error(`project_id '${projectId}' is not registered`);
         }
-        const countBy = (table) => Number(this.db.prepare(`SELECT COUNT(*) as cnt FROM ${table}
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
+        const countBy = (table) => Number(this.db
+            .prepare(`SELECT COUNT(*) as cnt FROM ${table}
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+            .get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
         const canPurge = project.lifecycle_status === "disabled";
         const reason = canPurge
             ? "safe to purge: lifecycle_status is disabled and explicit confirm is still required"
@@ -845,7 +884,9 @@ export class SlotDB {
         if (input.confirm !== true) {
             throw new Error("project.purge requires explicit confirm=true");
         }
-        const preview = this.purgePreviewProject(scopeUserId, scopeAgentId, { project_id: projectId });
+        const preview = this.purgePreviewProject(scopeUserId, scopeAgentId, {
+            project_id: projectId,
+        });
         if (!preview.purge_guard.allowed) {
             throw new Error(preview.purge_guard.reason);
         }
@@ -865,26 +906,46 @@ export class SlotDB {
         };
         this.db.exec("BEGIN");
         try {
-            this.db.prepare(`DELETE FROM project_aliases
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(scopeUserId, scopeAgentId, projectId);
-            this.db.prepare(`DELETE FROM project_tracker_mappings
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(scopeUserId, scopeAgentId, projectId);
-            this.db.prepare(`DELETE FROM project_registration_state
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(scopeUserId, scopeAgentId, projectId);
-            this.db.prepare(`DELETE FROM index_runs
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(scopeUserId, scopeAgentId, projectId);
-            this.db.prepare(`DELETE FROM project_index_watch_state
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(scopeUserId, scopeAgentId, projectId);
-            this.db.prepare(`DELETE FROM file_index_state
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(scopeUserId, scopeAgentId, projectId);
-            this.db.prepare(`DELETE FROM chunk_registry
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(scopeUserId, scopeAgentId, projectId);
-            this.db.prepare(`DELETE FROM symbol_registry
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(scopeUserId, scopeAgentId, projectId);
-            this.db.prepare(`DELETE FROM task_registry
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(scopeUserId, scopeAgentId, projectId);
-            this.db.prepare(`DELETE FROM projects
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`).run(scopeUserId, scopeAgentId, projectId);
+            this.db
+                .prepare(`DELETE FROM project_aliases
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+                .run(scopeUserId, scopeAgentId, projectId);
+            this.db
+                .prepare(`DELETE FROM project_tracker_mappings
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+                .run(scopeUserId, scopeAgentId, projectId);
+            this.db
+                .prepare(`DELETE FROM project_registration_state
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+                .run(scopeUserId, scopeAgentId, projectId);
+            this.db
+                .prepare(`DELETE FROM index_runs
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+                .run(scopeUserId, scopeAgentId, projectId);
+            this.db
+                .prepare(`DELETE FROM project_index_watch_state
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+                .run(scopeUserId, scopeAgentId, projectId);
+            this.db
+                .prepare(`DELETE FROM file_index_state
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+                .run(scopeUserId, scopeAgentId, projectId);
+            this.db
+                .prepare(`DELETE FROM chunk_registry
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+                .run(scopeUserId, scopeAgentId, projectId);
+            this.db
+                .prepare(`DELETE FROM symbol_registry
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+                .run(scopeUserId, scopeAgentId, projectId);
+            this.db
+                .prepare(`DELETE FROM task_registry
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+                .run(scopeUserId, scopeAgentId, projectId);
+            this.db
+                .prepare(`DELETE FROM projects
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?`)
+                .run(scopeUserId, scopeAgentId, projectId);
             this.db.exec("COMMIT");
         }
         catch (error) {
@@ -998,7 +1059,8 @@ export class SlotDB {
                         });
                     }
                     for (const block of blocks) {
-                        if (!block.symbol_name || !["function", "class", "method", "tool"].includes(block.kind))
+                        if (!block.symbol_name ||
+                            !["function", "class", "method", "tool"].includes(block.kind))
                             continue;
                         const symbolFqn = block.semantic_path || `${block.kind}:${block.symbol_name}`;
                         this.upsertSymbolRegistry(scopeUserId, scopeAgentId, {
@@ -1039,14 +1101,18 @@ export class SlotDB {
                 last_checksum_snapshot: checksumSnapshotRecord,
                 updated_at: nowIso,
             });
-            this.db.prepare(`UPDATE projects
+            this.db
+                .prepare(`UPDATE projects
          SET lifecycle_status = 'active', updated_at = ?
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND lifecycle_status = 'deindexed'`).run(nowIso, scopeUserId, scopeAgentId, input.project_id);
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND lifecycle_status = 'deindexed'`)
+                .run(nowIso, scopeUserId, scopeAgentId, input.project_id);
             this.finishIndexRun(scopeUserId, scopeAgentId, runId, "indexed", null, nowIso);
-            this.db.prepare(`UPDATE projects
+            this.db
+                .prepare(`UPDATE projects
          SET lifecycle_status = 'active', updated_at = ?
          WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?
-           AND lifecycle_status = 'deindexed'`).run(nowIso, scopeUserId, scopeAgentId, input.project_id);
+           AND lifecycle_status = 'deindexed'`)
+                .run(nowIso, scopeUserId, scopeAgentId, input.project_id);
             return {
                 run_id: runId,
                 project_id: input.project_id,
@@ -1086,7 +1152,9 @@ export class SlotDB {
         }
         const existing = this.getTaskRegistryRecordById(scopeUserId, scopeAgentId, taskId);
         const relatedTaskIds = this.normalizeStringArray(input.related_task_ids);
-        const filesTouched = this.normalizeStringArray(input.files_touched).map((p) => this.normalizeRelativePath(p)).filter(Boolean);
+        const filesTouched = this.normalizeStringArray(input.files_touched)
+            .map((p) => this.normalizeRelativePath(p))
+            .filter(Boolean);
         const symbolsTouched = this.normalizeStringArray(input.symbols_touched);
         const commitRefs = this.normalizeStringArray(input.commit_refs);
         const diffRefs = this.normalizeStringArray(input.diff_refs);
@@ -1220,18 +1288,37 @@ export class SlotDB {
         if (!project) {
             throw new Error(`project_id '${projectId}' is not registered`);
         }
-        const isSearchDisabled = ["deindexed", "detached", "disabled", "purged"].includes(project.lifecycle_status);
+        const isSearchDisabled = [
+            "deindexed",
+            "detached",
+            "disabled",
+            "purged",
+        ].includes(project.lifecycle_status);
         if (isSearchDisabled) {
-            const files = Number(this.db.prepare(`SELECT COUNT(*) as cnt FROM file_index_state
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND tombstone_at IS NOT NULL`).get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
-            const chunks = Number(this.db.prepare(`SELECT COUNT(*) as cnt FROM chunk_registry
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND tombstone_at IS NOT NULL`).get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
-            const symbols = Number(this.db.prepare(`SELECT COUNT(*) as cnt FROM symbol_registry
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND tombstone_at IS NOT NULL`).get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
+            const files = Number(this.db
+                .prepare(`SELECT COUNT(*) as cnt FROM file_index_state
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND tombstone_at IS NOT NULL`)
+                .get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
+            const chunks = Number(this.db
+                .prepare(`SELECT COUNT(*) as cnt FROM chunk_registry
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND tombstone_at IS NOT NULL`)
+                .get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
+            const symbols = Number(this.db
+                .prepare(`SELECT COUNT(*) as cnt FROM symbol_registry
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND tombstone_at IS NOT NULL`)
+                .get(scopeUserId, scopeAgentId, projectId)?.cnt || 0);
             const taskContextSelector = {
-                ...(input.task_context?.task_id ? { task_id: String(input.task_context.task_id).trim() } : {}),
-                ...(input.task_context?.tracker_issue_key ? { tracker_issue_key: String(input.task_context.tracker_issue_key).trim() } : {}),
-                ...(input.task_context?.task_title ? { task_title: String(input.task_context.task_title).trim() } : {}),
+                ...(input.task_context?.task_id
+                    ? { task_id: String(input.task_context.task_id).trim() }
+                    : {}),
+                ...(input.task_context?.tracker_issue_key
+                    ? {
+                        tracker_issue_key: String(input.task_context.tracker_issue_key).trim(),
+                    }
+                    : {}),
+                ...(input.task_context?.task_title
+                    ? { task_title: String(input.task_context.task_title).trim() }
+                    : {}),
             };
             const reasonByLifecycle = {
                 deindexed: "project is deindexed; retrieval is disabled until reindex",
@@ -1248,9 +1335,14 @@ export class SlotDB {
                 count: 0,
                 task_lineage_context: null,
                 task_context_resolution: {
-                    status: Object.keys(taskContextSelector).length > 0 ? "selector_not_resolved" : "not_requested",
+                    status: Object.keys(taskContextSelector).length > 0
+                        ? "selector_not_resolved"
+                        : "not_requested",
                     ...(Object.keys(taskContextSelector).length > 0
-                        ? { reason: reasonByLifecycle[project.lifecycle_status] || "project lifecycle disables retrieval" }
+                        ? {
+                            reason: reasonByLifecycle[project.lifecycle_status] ||
+                                "project lifecycle disables retrieval",
+                        }
                         : {}),
                     selector: taskContextSelector,
                     recoverable: project.lifecycle_status !== "purged",
@@ -1281,7 +1373,10 @@ export class SlotDB {
         }
         const limit = Math.min(Math.max(Number(input.limit || 10), 1), 50);
         const queryLc = query.toLowerCase();
-        const queryTokens = Array.from(new Set(queryLc.split(/[^a-z0-9._/-]+/i).map((t) => t.trim()).filter(Boolean)));
+        const queryTokens = Array.from(new Set(queryLc
+            .split(/[^a-z0-9._/-]+/i)
+            .map((t) => t.trim())
+            .filter(Boolean)));
         const tokenScore = (text) => {
             if (!queryTokens.length)
                 return 0;
@@ -1294,29 +1389,55 @@ export class SlotDB {
             return matched / queryTokens.length;
         };
         const exactMatchScore = (candidate) => {
-            const value = String(candidate || '').trim().toLowerCase();
+            const value = String(candidate || "")
+                .trim()
+                .toLowerCase();
             if (!value)
                 return 0;
             if (value === queryLc)
                 return 1;
             if (value.endsWith(`.${queryLc}`))
                 return 0.92;
-            if (value.includes(`/${queryLc}`) || value.includes(`:${queryLc}`) || value.includes(`#${queryLc}`))
+            if (value.includes(`/${queryLc}`) ||
+                value.includes(`:${queryLc}`) ||
+                value.includes(`#${queryLc}`))
                 return 0.78;
             return 0;
         };
-        const codeIntentHints = ['function', 'class', 'method', 'symbol', 'route', 'endpoint', 'extractor', 'registry', 'chunk', 'snippet', 'code'];
-        const looksCodeIntent = codeIntentHints.some((hint) => queryLc.includes(hint)) || query.includes('/') || query.includes('_');
+        const codeIntentHints = [
+            "function",
+            "class",
+            "method",
+            "symbol",
+            "route",
+            "endpoint",
+            "extractor",
+            "registry",
+            "chunk",
+            "snippet",
+            "code",
+        ];
+        const looksCodeIntent = codeIntentHints.some((hint) => queryLc.includes(hint)) ||
+            query.includes("/") ||
+            query.includes("_");
         const looksIdentifierQuery = /^[a-zA-Z_][a-zA-Z0-9_]*$/.test(query) ||
             /^[a-zA-Z_][a-zA-Z0-9_.#:-]*$/.test(query) ||
-            query.includes('::') ||
-            query.includes('.') ||
-            query.includes('_');
+            query.includes("::") ||
+            query.includes(".") ||
+            query.includes("_");
         const taskContextInput = input.task_context;
         const taskContextSelector = {
-            ...(taskContextInput?.task_id ? { task_id: String(taskContextInput.task_id).trim() } : {}),
-            ...(taskContextInput?.tracker_issue_key ? { tracker_issue_key: String(taskContextInput.tracker_issue_key).trim() } : {}),
-            ...(taskContextInput?.task_title ? { task_title: String(taskContextInput.task_title).trim() } : {}),
+            ...(taskContextInput?.task_id
+                ? { task_id: String(taskContextInput.task_id).trim() }
+                : {}),
+            ...(taskContextInput?.tracker_issue_key
+                ? {
+                    tracker_issue_key: String(taskContextInput.tracker_issue_key).trim(),
+                }
+                : {}),
+            ...(taskContextInput?.task_title
+                ? { task_title: String(taskContextInput.task_title).trim() }
+                : {}),
         };
         let lineageContext = null;
         let taskContextResolution = {
@@ -1353,7 +1474,9 @@ export class SlotDB {
                 };
             }
         }
-        const lexicalPathPrefix = this.normalizeStringArray(input.path_prefix).map((p) => this.normalizeRelativePath(p)).filter(Boolean);
+        const lexicalPathPrefix = this.normalizeStringArray(input.path_prefix)
+            .map((p) => this.normalizeRelativePath(p))
+            .filter(Boolean);
         const lexicalModules = new Set(this.normalizeStringArray(input.module).map((s) => s.toLowerCase()));
         const lexicalLanguages = new Set(this.normalizeStringArray(input.language).map((s) => s.toLowerCase()));
         const lexicalTaskIds = new Set(this.normalizeStringArray(input.task_id));
@@ -1362,7 +1485,10 @@ export class SlotDB {
             lexicalTaskIds.add(lineageContext.focus.task_id);
             if (lineageContext.focus.tracker_issue_key)
                 lexicalIssueKeys.add(lineageContext.focus.tracker_issue_key.toUpperCase());
-            for (const t of [...lineageContext.parent_chain, ...lineageContext.related_tasks]) {
+            for (const t of [
+                ...lineageContext.parent_chain,
+                ...lineageContext.related_tasks,
+            ]) {
                 lexicalTaskIds.add(t.task_id);
                 if (t.tracker_issue_key)
                     lexicalIssueKeys.add(t.tracker_issue_key.toUpperCase());
@@ -1389,15 +1515,20 @@ export class SlotDB {
             const relativePath = String(row.relative_path || "");
             const moduleName = row.module ? String(row.module) : null;
             const language = row.language ? String(row.language) : null;
-            if (lexicalPathPrefix.length > 0 && !lexicalPathPrefix.some((prefix) => relativePath.startsWith(prefix)))
+            if (lexicalPathPrefix.length > 0 &&
+                !lexicalPathPrefix.some((prefix) => relativePath.startsWith(prefix)))
                 continue;
             if (lexicalModules.size > 0 && !moduleName)
                 continue;
-            if (lexicalModules.size > 0 && moduleName && !lexicalModules.has(moduleName.toLowerCase()))
+            if (lexicalModules.size > 0 &&
+                moduleName &&
+                !lexicalModules.has(moduleName.toLowerCase()))
                 continue;
             if (lexicalLanguages.size > 0 && !language)
                 continue;
-            if (lexicalLanguages.size > 0 && language && !lexicalLanguages.has(language.toLowerCase()))
+            if (lexicalLanguages.size > 0 &&
+                language &&
+                !lexicalLanguages.has(language.toLowerCase()))
                 continue;
             const text = `${relativePath} ${moduleName || ""} ${language || ""}`.toLowerCase();
             let score = 0;
@@ -1407,12 +1538,16 @@ export class SlotDB {
             if (lineageContext && lineageContext.touched_files.includes(relativePath))
                 score += 0.35;
             if (looksCodeIntent) {
-                if (relativePath.includes('/docs/') || relativePath.startsWith('docs/') || relativePath.includes('README'))
+                if (relativePath.includes("/docs/") ||
+                    relativePath.startsWith("docs/") ||
+                    relativePath.includes("README"))
                     score -= 0.18;
-                if (relativePath.startsWith('src/') || relativePath.startsWith('tests/'))
+                if (relativePath.startsWith("src/") ||
+                    relativePath.startsWith("tests/"))
                     score += 0.14;
             }
-            else if (relativePath.includes("README") || relativePath.includes("docs/")) {
+            else if (relativePath.includes("README") ||
+                relativePath.includes("docs/")) {
                 score += 0.05;
             }
             if (looksIdentifierQuery) {
@@ -1420,7 +1555,7 @@ export class SlotDB {
             }
             if (score <= 0.08)
                 continue;
-            pushDebug('file_index_state', {
+            pushDebug("file_index_state", {
                 relative_path: relativePath,
                 score: Number(score.toFixed(4)),
                 module: moduleName,
@@ -1450,15 +1585,20 @@ export class SlotDB {
             const symbolKind = String(row.symbol_kind || "");
             const symbolFqn = String(row.symbol_fqn || "");
             symbolRowsById.set(String(row.symbol_id), row);
-            if (lexicalPathPrefix.length > 0 && !lexicalPathPrefix.some((prefix) => relativePath.startsWith(prefix)))
+            if (lexicalPathPrefix.length > 0 &&
+                !lexicalPathPrefix.some((prefix) => relativePath.startsWith(prefix)))
                 continue;
             if (lexicalModules.size > 0 && !moduleName)
                 continue;
-            if (lexicalModules.size > 0 && moduleName && !lexicalModules.has(moduleName.toLowerCase()))
+            if (lexicalModules.size > 0 &&
+                moduleName &&
+                !lexicalModules.has(moduleName.toLowerCase()))
                 continue;
             if (lexicalLanguages.size > 0 && !language)
                 continue;
-            if (lexicalLanguages.size > 0 && language && !lexicalLanguages.has(language.toLowerCase()))
+            if (lexicalLanguages.size > 0 &&
+                language &&
+                !lexicalLanguages.has(language.toLowerCase()))
                 continue;
             const text = `${symbolName} ${symbolFqn} ${relativePath} ${moduleName || ""} ${symbolKind}`.toLowerCase();
             let score = 0;
@@ -1479,13 +1619,14 @@ export class SlotDB {
                 score += 0.3;
             if (lineageContext && lineageContext.touched_files.includes(relativePath))
                 score += 0.12;
-            if (looksCodeIntent && (relativePath.startsWith('src/') || relativePath.startsWith('tests/')))
+            if (looksCodeIntent &&
+                (relativePath.startsWith("src/") || relativePath.startsWith("tests/")))
                 score += 0.08;
             if (looksIdentifierQuery)
                 score += 0.18;
             if (score <= 0.08)
                 continue;
-            pushDebug('symbol_registry', {
+            pushDebug("symbol_registry", {
                 relative_path: relativePath,
                 symbol_name: symbolName,
                 symbol_fqn: symbolFqn,
@@ -1517,9 +1658,10 @@ export class SlotDB {
             const chunkKind = String(row.chunk_kind || "");
             const symbolId = row.symbol_id ? String(row.symbol_id) : null;
             const symbolRow = symbolId ? symbolRowsById.get(symbolId) : null;
-            const symbolName = symbolRow ? String(symbolRow.symbol_name || '') : '';
-            const symbolFqn = symbolRow ? String(symbolRow.symbol_fqn || '') : '';
-            if (lexicalPathPrefix.length > 0 && !lexicalPathPrefix.some((prefix) => relativePath.startsWith(prefix)))
+            const symbolName = symbolRow ? String(symbolRow.symbol_name || "") : "";
+            const symbolFqn = symbolRow ? String(symbolRow.symbol_fqn || "") : "";
+            if (lexicalPathPrefix.length > 0 &&
+                !lexicalPathPrefix.some((prefix) => relativePath.startsWith(prefix)))
                 continue;
             const text = `${relativePath} ${chunkKind} ${symbolId || ""} ${symbolName} ${symbolFqn}`.toLowerCase();
             let score = 0;
@@ -1537,16 +1679,19 @@ export class SlotDB {
             if (lineageContext && lineageContext.touched_files.includes(relativePath))
                 score += 0.15;
             if (looksCodeIntent) {
-                if (relativePath.includes('/docs/') || relativePath.startsWith('docs/') || relativePath.includes('README'))
+                if (relativePath.includes("/docs/") ||
+                    relativePath.startsWith("docs/") ||
+                    relativePath.includes("README"))
                     score -= 0.14;
-                if (relativePath.startsWith('src/') || relativePath.startsWith('tests/'))
+                if (relativePath.startsWith("src/") ||
+                    relativePath.startsWith("tests/"))
                     score += 0.1;
             }
             if (looksIdentifierQuery)
                 score += 0.12;
             if (score <= 0.08)
                 continue;
-            pushDebug('chunk_registry', {
+            pushDebug("chunk_registry", {
                 relative_path: relativePath,
                 chunk_kind: chunkKind,
                 symbol_name: symbolName || null,
@@ -1562,7 +1707,9 @@ export class SlotDB {
                 project_id: projectId,
                 relative_path: relativePath,
                 symbol_name: symbolName || undefined,
-                snippet: symbolName ? `chunk ${chunkKind} for symbol ${symbolName} in ${relativePath}` : `chunk ${chunkKind} in ${relativePath}`,
+                snippet: symbolName
+                    ? `chunk ${chunkKind} for symbol ${symbolName} in ${relativePath}`
+                    : `chunk ${chunkKind} in ${relativePath}`,
             });
         }
         const taskStmt = this.db.prepare(`SELECT * FROM task_registry
@@ -1570,7 +1717,9 @@ export class SlotDB {
         const taskRows = taskStmt.all(scopeUserId, scopeAgentId, projectId);
         for (const row of taskRows) {
             const task = this.rowToTaskRecord(row);
-            const taskIssueKey = task.tracker_issue_key ? task.tracker_issue_key.toUpperCase() : null;
+            const taskIssueKey = task.tracker_issue_key
+                ? task.tracker_issue_key.toUpperCase()
+                : null;
             if (lexicalTaskIds.size > 0 && !lexicalTaskIds.has(task.task_id)) {
                 if (!taskIssueKey || !lexicalIssueKeys.has(taskIssueKey)) {
                     // keep if user query still lexically matches strongly
@@ -1585,7 +1734,9 @@ export class SlotDB {
                 ...(task.symbols_touched || []),
                 ...(task.commit_refs || []),
                 task.decision_notes || "",
-            ].join(" ").toLowerCase();
+            ]
+                .join(" ")
+                .toLowerCase();
             let score = 0;
             if (text.includes(queryLc))
                 score += 0.58;
@@ -1604,7 +1755,7 @@ export class SlotDB {
             }
             if (score <= 0.08)
                 continue;
-            pushDebug('task_registry', {
+            pushDebug("task_registry", {
                 task_id: task.task_id,
                 tracker_issue_key: task.tracker_issue_key,
                 task_title: task.task_title,
@@ -1649,10 +1800,18 @@ export class SlotDB {
                         task_registry: debugBuckets.task_registry.length,
                     },
                     top_candidates: {
-                        file_index_state: debugBuckets.file_index_state.sort((a, b) => Number(b.score || 0) - Number(a.score || 0)).slice(0, 8),
-                        symbol_registry: debugBuckets.symbol_registry.sort((a, b) => Number(b.score || 0) - Number(a.score || 0)).slice(0, 8),
-                        chunk_registry: debugBuckets.chunk_registry.sort((a, b) => Number(b.score || 0) - Number(a.score || 0)).slice(0, 8),
-                        task_registry: debugBuckets.task_registry.sort((a, b) => Number(b.score || 0) - Number(a.score || 0)).slice(0, 8),
+                        file_index_state: debugBuckets.file_index_state
+                            .sort((a, b) => Number(b.score || 0) - Number(a.score || 0))
+                            .slice(0, 8),
+                        symbol_registry: debugBuckets.symbol_registry
+                            .sort((a, b) => Number(b.score || 0) - Number(a.score || 0))
+                            .slice(0, 8),
+                        chunk_registry: debugBuckets.chunk_registry
+                            .sort((a, b) => Number(b.score || 0) - Number(a.score || 0))
+                            .slice(0, 8),
+                        task_registry: debugBuckets.task_registry
+                            .sort((a, b) => Number(b.score || 0) - Number(a.score || 0))
+                            .slice(0, 8),
                     },
                 }
                 : undefined,
@@ -1683,7 +1842,8 @@ export class SlotDB {
             if (!message.includes("task lineage focus not found for provided selector")) {
                 throw error;
             }
-            const unresolvedTaskId = taskIdSelector || `unresolved:${trackerSelector || taskTitleSelector || "selector"}`;
+            const unresolvedTaskId = taskIdSelector ||
+                `unresolved:${trackerSelector || taskTitleSelector || "selector"}`;
             const unresolvedTitle = taskTitleSelector || "Unresolved task lineage selector";
             return {
                 status: "selector_not_resolved",
@@ -1701,7 +1861,9 @@ export class SlotDB {
                 commit_refs: [],
             };
         }
-        const changedFiles = this.uniqueSorted((lineage.touched_files || []).map((p) => this.normalizeRelativePath(p)).filter(Boolean));
+        const changedFiles = this.uniqueSorted((lineage.touched_files || [])
+            .map((p) => this.normalizeRelativePath(p))
+            .filter(Boolean));
         const relatedSymbolsMap = new Map();
         for (const symbolName of lineage.touched_symbols || []) {
             const normalized = String(symbolName || "").trim();
@@ -1727,7 +1889,9 @@ export class SlotDB {
                 const symbolName = String(row.symbol_name || "").trim();
                 if (!symbolName)
                     continue;
-                const relPath = row.relative_path ? String(row.relative_path) : undefined;
+                const relPath = row.relative_path
+                    ? String(row.relative_path)
+                    : undefined;
                 const symbolFqn = row.symbol_fqn ? String(row.symbol_fqn) : undefined;
                 const key = `symbol_registry:${symbolName}:${symbolFqn || ""}:${relPath || ""}`;
                 if (!relatedSymbolsMap.has(key)) {
@@ -1757,8 +1921,7 @@ export class SlotDB {
         if (!project) {
             throw new Error(`project_id '${projectId}' is not registered`);
         }
-        const aliases = this.listProjects(scopeUserId, scopeAgentId)
-            .find((row) => row.project.project_id === projectId)?.aliases || [];
+        const aliases = this.listProjects(scopeUserId, scopeAgentId).find((row) => row.project.project_id === projectId)?.aliases || [];
         const registration = this.getProjectRegistrationState(scopeUserId, scopeAgentId, projectId);
         const trackerStmt = this.db.prepare(`SELECT * FROM project_tracker_mappings
        WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ?
@@ -1769,12 +1932,20 @@ export class SlotDB {
             scope_user_id: String(row.scope_user_id),
             scope_agent_id: String(row.scope_agent_id),
             tracker_type: String(row.tracker_type),
-            tracker_space_key: row.tracker_space_key ? String(row.tracker_space_key) : null,
-            tracker_project_id: row.tracker_project_id ? String(row.tracker_project_id) : null,
-            default_epic_key: row.default_epic_key ? String(row.default_epic_key) : null,
+            tracker_space_key: row.tracker_space_key
+                ? String(row.tracker_space_key)
+                : null,
+            tracker_project_id: row.tracker_project_id
+                ? String(row.tracker_project_id)
+                : null,
+            default_epic_key: row.default_epic_key
+                ? String(row.default_epic_key)
+                : null,
             board_key: row.board_key ? String(row.board_key) : null,
             active_version: row.active_version ? String(row.active_version) : null,
-            external_project_url: row.external_project_url ? String(row.external_project_url) : null,
+            external_project_url: row.external_project_url
+                ? String(row.external_project_url)
+                : null,
             created_at: String(row.created_at),
             updated_at: String(row.updated_at),
         }));
@@ -1807,7 +1978,9 @@ export class SlotDB {
         const recentTasks = taskStmt.all(scopeUserId, scopeAgentId, projectId).map((row) => ({
             task_id: String(row.task_id),
             task_title: String(row.task_title),
-            tracker_issue_key: row.tracker_issue_key ? String(row.tracker_issue_key) : null,
+            tracker_issue_key: row.tracker_issue_key
+                ? String(row.tracker_issue_key)
+                : null,
             task_status: row.task_status ? String(row.task_status) : null,
         }));
         const runStmt = this.db.prepare(`SELECT run_id, trigger_type, state, started_at, finished_at
@@ -1841,7 +2014,8 @@ export class SlotDB {
         const onlyAliases = new Set(this.normalizeStringArray(input.only_aliases).map((a) => this.normalizeProjectAlias(a)));
         const projects = this.listProjects(scopeUserId, scopeAgentId);
         const selected = projects.filter((row) => {
-            if (onlyProjectIds.size > 0 && !onlyProjectIds.has(row.project.project_id))
+            if (onlyProjectIds.size > 0 &&
+                !onlyProjectIds.has(row.project.project_id))
                 return false;
             if (onlyAliases.size > 0) {
                 const aliases = row.aliases.map((a) => this.normalizeProjectAlias(a.project_alias));
@@ -1859,7 +2033,9 @@ export class SlotDB {
             const project = row.project;
             const warnings = [];
             const actions = [];
-            const existingAliases = new Set(row.aliases.map((a) => this.normalizeProjectAlias(a.project_alias)).filter(Boolean));
+            const existingAliases = new Set(row.aliases
+                .map((a) => this.normalizeProjectAlias(a.project_alias))
+                .filter(Boolean));
             const inferredAliases = this.inferBackfillAliases(project, existingAliases, source);
             const inferredMappings = this.inferBackfillTrackerMappings(scopeUserId, scopeAgentId, project.project_id, project, source);
             if (mode === "apply") {
@@ -1873,10 +2049,10 @@ export class SlotDB {
                 }
                 for (const mapping of inferredMappings) {
                     const existing = this.getProjectTrackerMapping(scopeUserId, scopeAgentId, project.project_id, mapping.tracker_type);
-                    if (existing
-                        && existing.tracker_space_key === mapping.tracker_space_key
-                        && existing.default_epic_key === mapping.default_epic_key
-                        && existing.tracker_project_id === mapping.tracker_project_id) {
+                    if (existing &&
+                        existing.tracker_space_key === mapping.tracker_space_key &&
+                        existing.default_epic_key === mapping.default_epic_key &&
+                        existing.tracker_project_id === mapping.tracker_project_id) {
                         continue;
                     }
                     this.setProjectTrackerMapping(scopeUserId, scopeAgentId, {
@@ -1893,14 +2069,15 @@ export class SlotDB {
             const primaryAlias = this.pickPrimaryAlias(existingAliases, project);
             const completeness = this.computeRegistrationCompleteness(project, primaryAlias);
             const missingFields = this.computeMissingRegistrationFields(project, primaryAlias);
-            const hasTracker = inferredMappings.length > 0 || Boolean(this.getProjectTrackerMapping(scopeUserId, scopeAgentId, project.project_id, "jira"));
+            const hasTracker = inferredMappings.length > 0 ||
+                Boolean(this.getProjectTrackerMapping(scopeUserId, scopeAgentId, project.project_id, "jira"));
             const status = hasTracker && completeness >= 90 ? "validated" : "registered";
             const validationStatus = missingFields.length === 0 ? "ok" : "warn";
             const existingRegistration = this.getProjectRegistrationState(scopeUserId, scopeAgentId, project.project_id);
-            const shouldUpdateRegistration = !existingRegistration
-                || input.force_registration_state === true
-                || existingRegistration.registration_status === "draft"
-                || existingRegistration.validation_status !== validationStatus;
+            const shouldUpdateRegistration = !existingRegistration ||
+                input.force_registration_state === true ||
+                existingRegistration.registration_status === "draft" ||
+                existingRegistration.validation_status !== validationStatus;
             if (shouldUpdateRegistration) {
                 if (mode === "apply") {
                     this.upsertProjectRegistrationState(scopeUserId, scopeAgentId, {
@@ -2036,38 +2213,54 @@ export class SlotDB {
         stmt.run(tombstoneAt, tombstoneAt, scopeUserId, scopeAgentId, projectId, relativePath);
     }
     upsertChunkRegistry(scopeUserId, scopeAgentId, input) {
-        const existing = this.db.prepare(`SELECT chunk_id FROM chunk_registry WHERE scope_user_id = ? AND scope_agent_id = ? AND chunk_id = ?`).get(scopeUserId, scopeAgentId, input.chunk_id);
+        const existing = this.db
+            .prepare(`SELECT chunk_id FROM chunk_registry WHERE scope_user_id = ? AND scope_agent_id = ? AND chunk_id = ?`)
+            .get(scopeUserId, scopeAgentId, input.chunk_id);
         if (existing) {
-            this.db.prepare(`UPDATE chunk_registry
+            this.db
+                .prepare(`UPDATE chunk_registry
          SET project_id = ?, file_id = ?, relative_path = ?, chunk_kind = ?, symbol_id = ?, task_id = ?, checksum = ?, qdrant_point_id = ?, index_state = ?, active = ?, tombstone_at = ?, indexed_at = ?
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND chunk_id = ?`).run(input.project_id, input.file_id, input.relative_path, input.chunk_kind, input.symbol_id, input.task_id || null, input.checksum, input.qdrant_point_id || null, input.index_state, input.active, input.tombstone_at, input.indexed_at, scopeUserId, scopeAgentId, input.chunk_id);
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND chunk_id = ?`)
+                .run(input.project_id, input.file_id, input.relative_path, input.chunk_kind, input.symbol_id, input.task_id || null, input.checksum, input.qdrant_point_id || null, input.index_state, input.active, input.tombstone_at, input.indexed_at, scopeUserId, scopeAgentId, input.chunk_id);
             return;
         }
-        this.db.prepare(`INSERT INTO chunk_registry (
+        this.db
+            .prepare(`INSERT INTO chunk_registry (
         chunk_id, scope_user_id, scope_agent_id, project_id, file_id, relative_path, chunk_kind, symbol_id, task_id, checksum, qdrant_point_id, index_state, active, tombstone_at, indexed_at
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(input.chunk_id, scopeUserId, scopeAgentId, input.project_id, input.file_id, input.relative_path, input.chunk_kind, input.symbol_id, input.task_id || null, input.checksum, input.qdrant_point_id || null, input.index_state, input.active, input.tombstone_at, input.indexed_at);
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(input.chunk_id, scopeUserId, scopeAgentId, input.project_id, input.file_id, input.relative_path, input.chunk_kind, input.symbol_id, input.task_id || null, input.checksum, input.qdrant_point_id || null, input.index_state, input.active, input.tombstone_at, input.indexed_at);
     }
     upsertSymbolRegistry(scopeUserId, scopeAgentId, input) {
-        const existing = this.db.prepare(`SELECT symbol_id FROM symbol_registry WHERE scope_user_id = ? AND scope_agent_id = ? AND symbol_id = ?`).get(scopeUserId, scopeAgentId, input.symbol_id);
+        const existing = this.db
+            .prepare(`SELECT symbol_id FROM symbol_registry WHERE scope_user_id = ? AND scope_agent_id = ? AND symbol_id = ?`)
+            .get(scopeUserId, scopeAgentId, input.symbol_id);
         if (existing) {
-            this.db.prepare(`UPDATE symbol_registry
+            this.db
+                .prepare(`UPDATE symbol_registry
          SET project_id = ?, relative_path = ?, module = ?, language = ?, symbol_name = ?, symbol_fqn = ?, symbol_kind = ?, signature_hash = ?, index_state = ?, active = ?, tombstone_at = ?, indexed_at = ?
-         WHERE scope_user_id = ? AND scope_agent_id = ? AND symbol_id = ?`).run(input.project_id, input.relative_path, input.module, input.language, input.symbol_name, input.symbol_fqn, input.symbol_kind, input.signature_hash || null, input.index_state, input.active, input.tombstone_at, input.indexed_at, scopeUserId, scopeAgentId, input.symbol_id);
+         WHERE scope_user_id = ? AND scope_agent_id = ? AND symbol_id = ?`)
+                .run(input.project_id, input.relative_path, input.module, input.language, input.symbol_name, input.symbol_fqn, input.symbol_kind, input.signature_hash || null, input.index_state, input.active, input.tombstone_at, input.indexed_at, scopeUserId, scopeAgentId, input.symbol_id);
             return;
         }
-        this.db.prepare(`INSERT INTO symbol_registry (
+        this.db
+            .prepare(`INSERT INTO symbol_registry (
         symbol_id, scope_user_id, scope_agent_id, project_id, relative_path, module, language, symbol_name, symbol_fqn, symbol_kind, signature_hash, index_state, active, tombstone_at, indexed_at
-      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(input.symbol_id, scopeUserId, scopeAgentId, input.project_id, input.relative_path, input.module, input.language, input.symbol_name, input.symbol_fqn, input.symbol_kind, input.signature_hash || null, input.index_state, input.active, input.tombstone_at, input.indexed_at);
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+            .run(input.symbol_id, scopeUserId, scopeAgentId, input.project_id, input.relative_path, input.module, input.language, input.symbol_name, input.symbol_fqn, input.symbol_kind, input.signature_hash || null, input.index_state, input.active, input.tombstone_at, input.indexed_at);
     }
     markProjectChunksByFileDeleted(scopeUserId, scopeAgentId, projectId, relativePath, tombstoneAt) {
-        this.db.prepare(`UPDATE chunk_registry
+        this.db
+            .prepare(`UPDATE chunk_registry
        SET index_state = 'stale', active = 0, tombstone_at = ?, indexed_at = ?
-       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND relative_path = ?`).run(tombstoneAt, tombstoneAt, scopeUserId, scopeAgentId, projectId, relativePath);
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND relative_path = ?`)
+            .run(tombstoneAt, tombstoneAt, scopeUserId, scopeAgentId, projectId, relativePath);
     }
     markProjectSymbolsByFileDeleted(scopeUserId, scopeAgentId, projectId, relativePath, tombstoneAt) {
-        this.db.prepare(`UPDATE symbol_registry
+        this.db
+            .prepare(`UPDATE symbol_registry
        SET index_state = 'stale', active = 0, tombstone_at = ?, indexed_at = ?
-       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND relative_path = ?`).run(tombstoneAt, tombstoneAt, scopeUserId, scopeAgentId, projectId, relativePath);
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND relative_path = ?`)
+            .run(tombstoneAt, tombstoneAt, scopeUserId, scopeAgentId, projectId, relativePath);
     }
     markProjectFileDeletedForEvent(scopeUserId, scopeAgentId, projectId, relativePath, tombstoneAt) {
         this.markFileIndexStateDeleted(scopeUserId, scopeAgentId, projectId, relativePath, tombstoneAt);
@@ -2117,9 +2310,7 @@ export class SlotDB {
     normalizeStringArray(input) {
         if (!Array.isArray(input))
             return [];
-        return this.uniqueSorted(input
-            .map((item) => String(item || "").trim())
-            .filter(Boolean));
+        return this.uniqueSorted(input.map((item) => String(item || "").trim()).filter(Boolean));
     }
     uniqueSorted(values) {
         return Array.from(new Set(values.map((v) => String(v || "").trim()).filter(Boolean))).sort((a, b) => a.localeCompare(b));
@@ -2128,7 +2319,10 @@ export class SlotDB {
         const candidates = new Set();
         if (source === "repo_root" || source === "mixed") {
             if (project.repo_root) {
-                const parts = project.repo_root.replace(/\\/g, "/").split("/").filter(Boolean);
+                const parts = project.repo_root
+                    .replace(/\\/g, "/")
+                    .split("/")
+                    .filter(Boolean);
                 const leaf = parts[parts.length - 1] || "";
                 const normalized = this.normalizeProjectAlias(leaf);
                 if (normalized)
@@ -2138,7 +2332,7 @@ export class SlotDB {
         if (source === "repo_remote" || source === "mixed") {
             if (project.repo_remote_primary) {
                 const remote = String(project.repo_remote_primary);
-                const m = remote.match(/[:\/]([^/]+?)\.git$/i) || remote.match(/[:\/]([^/]+?)$/i);
+                const m = remote.match(/[:/]([^/]+?)\.git$/i) || remote.match(/[:/]([^/]+?)$/i);
                 const repoName = m?.[1] || "";
                 const normalized = this.normalizeProjectAlias(repoName);
                 if (normalized)
@@ -2168,7 +2362,9 @@ export class SlotDB {
          WHERE scope_user_id = ? AND scope_agent_id = ? AND project_id = ? AND tracker_issue_key IS NOT NULL AND tracker_issue_key != ''
          ORDER BY updated_at DESC LIMIT 200`);
             const rows = stmt.all(scopeUserId, scopeAgentId, projectId);
-            const keys = rows.map((r) => String(r.tracker_issue_key || "").trim()).filter(Boolean);
+            const keys = rows
+                .map((r) => String(r.tracker_issue_key || "").trim())
+                .filter(Boolean);
             const jiraLike = keys
                 .map((key) => key.match(/^([A-Z][A-Z0-9_]+)-\d+$/)?.[1] || null)
                 .filter((x) => Boolean(x));
@@ -2199,7 +2395,9 @@ export class SlotDB {
         return Array.from(dedup.values()).sort((a, b) => b.confidence - a.confidence);
     }
     pickPrimaryAlias(existingAliases, project) {
-        const aliases = Array.from(existingAliases).filter(Boolean).sort((a, b) => a.localeCompare(b));
+        const aliases = Array.from(existingAliases)
+            .filter(Boolean)
+            .sort((a, b) => a.localeCompare(b));
         if (aliases.length > 0)
             return aliases[0];
         const fromName = this.normalizeProjectAlias(project.project_name);
@@ -2223,6 +2421,23 @@ export class SlotDB {
       ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`);
         insertStmt.run(input.migration_id, scopeUserId, scopeAgentId, input.schema_from, input.schema_to, input.applied_at, input.status, input.notes || null);
     }
+    recordMigrationState(scopeUserId, scopeAgentId, input) {
+        this.upsertMigrationState(scopeUserId, scopeAgentId, input);
+    }
+    getMigrationState(scopeUserId, scopeAgentId, migrationId) {
+        const stmt = this.db.prepare(`SELECT migration_id, schema_from, schema_to, applied_at, status, notes
+       FROM migration_state
+       WHERE scope_user_id = ? AND scope_agent_id = ? AND migration_id = ?`);
+        const row = stmt.get(scopeUserId, scopeAgentId, migrationId);
+        return row || null;
+    }
+    getMigrationStates(scopeUserId, scopeAgentId) {
+        const stmt = this.db.prepare(`SELECT migration_id, schema_from, schema_to, applied_at, status, notes
+       FROM migration_state
+       WHERE scope_user_id = ? AND scope_agent_id = ?
+       ORDER BY applied_at DESC`);
+        return stmt.all(scopeUserId, scopeAgentId);
+    }
     rowToTaskRecord(row) {
         return {
             task_id: row.task_id,
@@ -2255,16 +2470,25 @@ export class SlotDB {
     }
     computeRegistrationCompleteness(project, alias) {
         const requiredTotal = 3;
-        const requiredPresent = [project.project_id, alias, project.project_name].filter(Boolean).length;
+        const requiredPresent = [
+            project.project_id,
+            alias,
+            project.project_name,
+        ].filter(Boolean).length;
         const optionalTotal = 3;
-        const optionalPresent = [project.repo_root, project.repo_remote_primary, project.active_version].filter(Boolean).length;
-        return Math.round((requiredPresent / requiredTotal) * 80 + (optionalPresent / optionalTotal) * 20);
+        const optionalPresent = [
+            project.repo_root,
+            project.repo_remote_primary,
+            project.active_version,
+        ].filter(Boolean).length;
+        return Math.round((requiredPresent / requiredTotal) * 80 +
+            (optionalPresent / optionalTotal) * 20);
     }
     upsertProjectAlias(scopeUserId, scopeAgentId, projectId, projectAlias, isPrimary, now, allowAliasUpdate) {
         const existingAlias = this.getProjectAlias(scopeUserId, scopeAgentId, projectAlias);
         if (existingAlias) {
             if (existingAlias.project_id !== projectId && !allowAliasUpdate) {
-                throw new Error(`project_alias \"${projectAlias}\" is already mapped to another project_id`);
+                throw new Error(`project_alias "${projectAlias}" is already mapped to another project_id`);
             }
             const stmt = this.db.prepare(`UPDATE project_aliases SET project_id = ?, is_primary = ?, updated_at = ? WHERE id = ?`);
             stmt.run(projectId, isPrimary ? 1 : 0, now, existingAlias.id);
@@ -2329,7 +2553,7 @@ export class SlotDB {
          AND expires_at IS NOT NULL AND expires_at < ?`);
         stmt.run(scopeUserId, scopeAgentId, now);
         // Auto-expire slots based on category TTL (auto_capture source)
-        const categories = ['project', 'environment', 'custom'];
+        const categories = ["project", "environment", "custom"];
         for (const cat of categories) {
             const ttlDays = getSlotTTL(cat);
             const cutoff = new Date(Date.now() - ttlDays * 24 * 60 * 60 * 1000).toISOString();
@@ -2342,7 +2566,7 @@ export class SlotDB {
         }
         // Safety cleanup: volatile project status slots should expire even if source was manual/tool.
         // This prevents stale "current phase/task" slots from persisting forever.
-        const projectCutoff = new Date(Date.now() - getSlotTTL('project') * 24 * 60 * 60 * 1000).toISOString();
+        const projectCutoff = new Date(Date.now() - getSlotTTL("project") * 24 * 60 * 60 * 1000).toISOString();
         const volatileProjectStmt = this.db.prepare(`DELETE FROM slots
        WHERE scope_user_id = ? AND scope_agent_id = ?
          AND category = 'project'