@intrect/openswarm 0.2.1 → 0.3.0

package/dist/registry/sqliteStore.js

@@ -0,0 +1,688 @@
+// ============================================
+// OpenSwarm - Code Registry SQLite Store
+// Created: 2026-04-10
+// Purpose: better-sqlite3 기반 코드 엔티티 레지스트리
+// Dependencies: better-sqlite3, nanoid
+// ============================================
+import Database from 'better-sqlite3';
+import { nanoid } from 'nanoid';
+import { resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { mkdirSync } from 'node:fs';
+const DEFAULT_DB_PATH = resolve(homedir(), '.openswarm', 'registry.db');
+// ============ Store 구현 ============
+export class SqliteRegistryStore {
+    db;
+    constructor(dbPath) {
+        const path = dbPath ?? DEFAULT_DB_PATH;
+        mkdirSync(resolve(path, '..'), { recursive: true });
+        this.db = new Database(path);
+        this.db.pragma('journal_mode = WAL');
+        this.db.pragma('foreign_keys = ON');
+        this.migrate();
+    }
+    migrate() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS code_entities (
+        id TEXT PRIMARY KEY,
+        project_id TEXT NOT NULL,
+        kind TEXT NOT NULL,
+        name TEXT NOT NULL,
+        qualified_name TEXT NOT NULL UNIQUE,
+        file_path TEXT NOT NULL,
+        line_start INTEGER,
+        line_end INTEGER,
+        signature TEXT,
+        status TEXT DEFAULT 'active',
+        deprecated_at TEXT,
+        deprecated_reason TEXT,
+        has_tests INTEGER DEFAULT 0,
+        test_file TEXT,
+        author TEXT,
+        maintainer TEXT,
+        complexity_score INTEGER,
+        risk_level TEXT DEFAULT 'low',
+        description TEXT DEFAULT '',
+        notes TEXT DEFAULT '',
+        knowledge_node_id TEXT,
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS code_entity_tags (
+        entity_id TEXT NOT NULL,
+        tag TEXT NOT NULL,
+        value TEXT,
+        PRIMARY KEY (entity_id, tag),
+        FOREIGN KEY (entity_id) REFERENCES code_entities(id) ON DELETE CASCADE
+      );
+
+      CREATE TABLE IF NOT EXISTS code_entity_warnings (
+        id TEXT PRIMARY KEY,
+        entity_id TEXT NOT NULL,
+        severity TEXT NOT NULL,
+        category TEXT NOT NULL,
+        message TEXT NOT NULL,
+        resolved INTEGER DEFAULT 0,
+        resolved_at TEXT,
+        created_at TEXT NOT NULL,
+        FOREIGN KEY (entity_id) REFERENCES code_entities(id) ON DELETE CASCADE
+      );
+
+      CREATE TABLE IF NOT EXISTS code_entity_relations (
+        source_id TEXT NOT NULL,
+        target_id TEXT NOT NULL,
+        relation_type TEXT NOT NULL,
+        PRIMARY KEY (source_id, target_id, relation_type),
+        FOREIGN KEY (source_id) REFERENCES code_entities(id) ON DELETE CASCADE,
+        FOREIGN KEY (target_id) REFERENCES code_entities(id) ON DELETE CASCADE
+      );
+
+      CREATE TABLE IF NOT EXISTS code_entity_issue_links (
+        entity_id TEXT NOT NULL,
+        issue_id TEXT NOT NULL,
+        linked_at TEXT NOT NULL,
+        PRIMARY KEY (entity_id, issue_id),
+        FOREIGN KEY (entity_id) REFERENCES code_entities(id) ON DELETE CASCADE
+      );
+
+      CREATE TABLE IF NOT EXISTS code_entity_memory_links (
+        entity_id TEXT NOT NULL,
+        memory_id TEXT NOT NULL,
+        linked_at TEXT NOT NULL,
+        PRIMARY KEY (entity_id, memory_id),
+        FOREIGN KEY (entity_id) REFERENCES code_entities(id) ON DELETE CASCADE
+      );
+
+      CREATE TABLE IF NOT EXISTS code_entity_events (
+        id TEXT PRIMARY KEY,
+        entity_id TEXT NOT NULL,
+        type TEXT NOT NULL,
+        old_value TEXT,
+        new_value TEXT,
+        content TEXT,
+        actor TEXT DEFAULT 'system',
+        created_at TEXT NOT NULL,
+        FOREIGN KEY (entity_id) REFERENCES code_entities(id) ON DELETE CASCADE
+      );
+
+      -- FTS5 전문검색
+      CREATE VIRTUAL TABLE IF NOT EXISTS code_entities_fts USING fts5(
+        name, qualified_name, description, notes, signature,
+        content=code_entities, content_rowid=rowid
+      );
+
+      -- 인덱스
+      CREATE INDEX IF NOT EXISTS idx_ce_project ON code_entities(project_id);
+      CREATE INDEX IF NOT EXISTS idx_ce_kind ON code_entities(kind);
+      CREATE INDEX IF NOT EXISTS idx_ce_file ON code_entities(file_path);
+      CREATE INDEX IF NOT EXISTS idx_ce_status ON code_entities(status);
+      CREATE INDEX IF NOT EXISTS idx_ce_has_tests ON code_entities(has_tests);
+      CREATE INDEX IF NOT EXISTS idx_ce_risk ON code_entities(risk_level);
+      CREATE INDEX IF NOT EXISTS idx_ce_knowledge ON code_entities(knowledge_node_id);
+      CREATE INDEX IF NOT EXISTS idx_ce_events_entity ON code_entity_events(entity_id);
+      CREATE INDEX IF NOT EXISTS idx_ce_events_created ON code_entity_events(created_at);
+      CREATE INDEX IF NOT EXISTS idx_ce_tags_tag ON code_entity_tags(tag);
+      CREATE INDEX IF NOT EXISTS idx_ce_warnings_sev ON code_entity_warnings(severity);
+      CREATE INDEX IF NOT EXISTS idx_ce_warnings_entity ON code_entity_warnings(entity_id);
+
+      -- FTS 트리거
+      CREATE TRIGGER IF NOT EXISTS ce_fts_ai AFTER INSERT ON code_entities BEGIN
+        INSERT INTO code_entities_fts(rowid, name, qualified_name, description, notes, signature)
+        VALUES (new.rowid, new.name, new.qualified_name, new.description, new.notes, new.signature);
+      END;
+      CREATE TRIGGER IF NOT EXISTS ce_fts_ad AFTER DELETE ON code_entities BEGIN
+        INSERT INTO code_entities_fts(code_entities_fts, rowid, name, qualified_name, description, notes, signature)
+        VALUES ('delete', old.rowid, old.name, old.qualified_name, old.description, old.notes, old.signature);
+      END;
+      CREATE TRIGGER IF NOT EXISTS ce_fts_au AFTER UPDATE ON code_entities BEGIN
+        INSERT INTO code_entities_fts(code_entities_fts, rowid, name, qualified_name, description, notes, signature)
+        VALUES ('delete', old.rowid, old.name, old.qualified_name, old.description, old.notes, old.signature);
+        INSERT INTO code_entities_fts(rowid, name, qualified_name, description, notes, signature)
+        VALUES (new.rowid, new.name, new.qualified_name, new.description, new.notes, new.signature);
+      END;
+    `);
+    }
+    // ============ 엔티티 CRUD ============
+    registerEntity(input) {
+        const id = nanoid(12);
+        const now = new Date().toISOString();
+        const qualifiedName = `${input.filePath}::${input.name}`;
+        const insertEntity = this.db.prepare(`
+      INSERT INTO code_entities (
+        id, project_id, kind, name, qualified_name, file_path,
+        line_start, line_end, signature, status,
+        has_tests, test_file, author, maintainer,
+        complexity_score, risk_level, description, notes,
+        knowledge_node_id, created_at, updated_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        const insertTag = this.db.prepare('INSERT OR IGNORE INTO code_entity_tags (entity_id, tag, value) VALUES (?, ?, ?)');
+        const insertEvent = this.db.prepare(`
+      INSERT INTO code_entity_events (id, entity_id, type, new_value, actor, created_at)
+      VALUES (?, ?, 'created', ?, 'system', ?)
+    `);
+        const transaction = this.db.transaction(() => {
+            insertEntity.run(id, input.projectId, input.kind, input.name, qualifiedName, input.filePath, input.lineStart ?? null, input.lineEnd ?? null, input.signature ?? null, input.status ?? 'active', input.hasTests ? 1 : 0, input.testFile ?? null, input.author ?? null, input.maintainer ?? null, input.complexityScore ?? null, input.riskLevel ?? 'low', input.description ?? '', input.notes ?? '', input.knowledgeNodeId ?? null, now, now);
+            for (const t of input.tags ?? []) {
+                insertTag.run(id, t.tag, t.value ?? null);
+            }
+            insertEvent.run(nanoid(12), id, input.name, now);
+        });
+        transaction();
+        const entity = this.getEntity(id);
+        if (!entity)
+            throw new Error(`Failed to register entity: ${qualifiedName} — row not found after insert`);
+        return entity;
+    }
+    bulkRegisterEntities(inputs) {
+        const results = [];
+        const transaction = this.db.transaction(() => {
+            for (const input of inputs) {
+                results.push(this.registerEntity(input));
+            }
+        });
+        transaction();
+        return results;
+    }
+    getEntity(id) {
+        const row = this.db.prepare('SELECT * FROM code_entities WHERE id = ?').get(id);
+        if (!row)
+            return null;
+        return this.rowToEntity(row);
+    }
+    getEntityByName(qualifiedName) {
+        const row = this.db.prepare('SELECT * FROM code_entities WHERE qualified_name = ?').get(qualifiedName);
+        if (!row)
+            return null;
+        return this.rowToEntity(row);
+    }
+    updateEntity(id, patch, actor = 'system') {
+        const existing = this.getEntity(id);
+        if (!existing)
+            return null;
+        const now = new Date().toISOString();
+        const fields = [];
+        const values = [];
+        const fieldMap = {
+            name: 'name', lineStart: 'line_start', lineEnd: 'line_end',
+            signature: 'signature', hasTests: 'has_tests', testFile: 'test_file',
+            maintainer: 'maintainer', complexityScore: 'complexity_score',
+            riskLevel: 'risk_level', description: 'description', notes: 'notes',
+        };
+        for (const [key, col] of Object.entries(fieldMap)) {
+            if (key in patch && patch[key] !== undefined) {
+                const val = patch[key];
+                fields.push(`${col} = ?`);
+                values.push(key === 'hasTests' ? (val ? 1 : 0) : (val ?? null));
+            }
+        }
+        if (fields.length === 0)
+            return existing;
+        // qualified_name 갱신 (name 변경 시)
+        if (patch.name && patch.name !== existing.name) {
+            fields.push('qualified_name = ?');
+            values.push(`${existing.filePath}::${patch.name}`);
+        }
+        fields.push('updated_at = ?');
+        values.push(now);
+        values.push(id);
+        this.db.prepare(`UPDATE code_entities SET ${fields.join(', ')} WHERE id = ?`).run(...values);
+        this.addEvent(id, 'updated', {
+            content: `fields: ${Object.keys(patch).join(', ')}`,
+            actor,
+        });
+        return this.getEntity(id);
+    }
+    removeEntity(id) {
+        const result = this.db.prepare('DELETE FROM code_entities WHERE id = ?').run(id);
+        return result.changes > 0;
+    }
+    listEntities(filter) {
+        const conditions = [];
+        const params = [];
+        if (filter?.projectId) {
+            conditions.push('e.project_id = ?');
+            params.push(filter.projectId);
+        }
+        if (filter?.kind && filter.kind.length > 0) {
+            conditions.push(`e.kind IN (${filter.kind.map(() => '?').join(',')})`);
+            params.push(...filter.kind);
+        }
+        if (filter?.status && filter.status.length > 0) {
+            conditions.push(`e.status IN (${filter.status.map(() => '?').join(',')})`);
+            params.push(...filter.status);
+        }
+        if (filter?.filePath) {
+            conditions.push('e.file_path = ?');
+            params.push(filter.filePath);
+        }
+        if (filter?.hasTests !== undefined) {
+            conditions.push('e.has_tests = ?');
+            params.push(filter.hasTests ? 1 : 0);
+        }
+        if (filter?.riskLevel && filter.riskLevel.length > 0) {
+            conditions.push(`e.risk_level IN (${filter.riskLevel.map(() => '?').join(',')})`);
+            params.push(...filter.riskLevel);
+        }
+        if (filter?.author) {
+            conditions.push('e.author = ?');
+            params.push(filter.author);
+        }
+        if (filter?.tags && filter.tags.length > 0) {
+            conditions.push(`e.id IN (
+        SELECT entity_id FROM code_entity_tags WHERE tag IN (${filter.tags.map(() => '?').join(',')})
+      )`);
+            params.push(...filter.tags);
+        }
+        // FTS 전문검색
+        let ftsJoin = '';
+        if (filter?.search) {
+            ftsJoin = 'INNER JOIN code_entities_fts ON code_entities_fts.rowid = e.rowid';
+            conditions.push('code_entities_fts MATCH ?');
+            params.push(filter.search);
+        }
+        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
+        const limit = filter?.limit ?? 50;
+        const offset = filter?.offset ?? 0;
+        const countRow = this.db.prepare(`SELECT COUNT(*) as cnt FROM code_entities e ${ftsJoin} ${where}`).get(...params);
+        const total = countRow.cnt;
+        const rows = this.db.prepare(`
+      SELECT e.* FROM code_entities e ${ftsJoin} ${where}
+      ORDER BY e.file_path, e.line_start NULLS LAST, e.name
+      LIMIT ? OFFSET ?
+    `).all(...params, limit, offset);
+        return {
+            entities: this.rowsToEntities(rows),
+            total,
+        };
+    }
+    // ============ 상태 관리 ============
+    deprecateEntity(id, reason, actor = 'system') {
+        const existing = this.getEntity(id);
+        if (!existing)
+            return null;
+        const now = new Date().toISOString();
+        this.db.prepare(`
+      UPDATE code_entities SET status = 'deprecated', deprecated_at = ?, deprecated_reason = ?, updated_at = ?
+      WHERE id = ?
+    `).run(now, reason ?? null, now, id);
+        this.addEvent(id, 'deprecated', {
+            oldValue: existing.status,
+            newValue: 'deprecated',
+            content: reason,
+            actor,
+        });
+        return this.getEntity(id);
+    }
+    changeEntityStatus(id, status, actor = 'system') {
+        const existing = this.getEntity(id);
+        if (!existing)
+            return null;
+        const now = new Date().toISOString();
+        this.db.prepare('UPDATE code_entities SET status = ?, updated_at = ? WHERE id = ?').run(status, now, id);
+        this.addEvent(id, 'status_changed', {
+            oldValue: existing.status,
+            newValue: status,
+            actor,
+        });
+        return this.getEntity(id);
+    }
+    // ============ 태그 ============
+    addTag(entityId, tag, value) {
+        this.db.prepare('INSERT OR REPLACE INTO code_entity_tags (entity_id, tag, value) VALUES (?, ?, ?)').run(entityId, tag, value ?? null);
+        const now = new Date().toISOString();
+        this.db.prepare('UPDATE code_entities SET updated_at = ? WHERE id = ?').run(now, entityId);
+        this.addEvent(entityId, 'tag_added', { newValue: tag });
+    }
+    removeTag(entityId, tag) {
+        this.db.prepare('DELETE FROM code_entity_tags WHERE entity_id = ? AND tag = ?').run(entityId, tag);
+        this.addEvent(entityId, 'tag_removed', { oldValue: tag });
+    }
+    getTags(entityId) {
+        return this.db.prepare('SELECT tag, value FROM code_entity_tags WHERE entity_id = ?').all(entityId).map(r => ({ tag: r.tag, value: r.value ?? undefined }));
+    }
+    // ============ 경고 ============
+    addWarning(entityId, severity, category, message) {
+        const id = nanoid(12);
+        const now = new Date().toISOString();
+        this.db.prepare(`
+      INSERT INTO code_entity_warnings (id, entity_id, severity, category, message, created_at)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `).run(id, entityId, severity, category, message, now);
+        this.db.prepare('UPDATE code_entities SET updated_at = ? WHERE id = ?').run(now, entityId);
+        this.addEvent(entityId, 'warning_added', {
+            newValue: `${severity}:${category}`,
+            content: message,
+        });
+        return {
+            id, entityId, severity, category, message,
+            resolved: false, createdAt: now,
+        };
+    }
+    resolveWarning(warningId) {
+        const now = new Date().toISOString();
+        const warning = this.db.prepare('SELECT * FROM code_entity_warnings WHERE id = ?').get(warningId);
+        if (!warning)
+            return false;
+        this.db.prepare('UPDATE code_entity_warnings SET resolved = 1, resolved_at = ? WHERE id = ?').run(now, warningId);
+        this.addEvent(warning.entity_id, 'warning_resolved', {
+            oldValue: `${warning.severity}:${warning.category}`,
+            content: warning.message,
+        });
+        return true;
+    }
+    getWarnings(entityId) {
+        return this.db.prepare('SELECT * FROM code_entity_warnings WHERE entity_id = ? ORDER BY created_at DESC').all(entityId).map(this.rowToWarning);
+    }
+    getUnresolvedWarnings(severity) {
+        const where = severity
+            ? 'WHERE resolved = 0 AND severity = ?'
+            : 'WHERE resolved = 0';
+        const params = severity ? [severity] : [];
+        return this.db.prepare(`SELECT * FROM code_entity_warnings ${where} ORDER BY
+        CASE severity WHEN 'critical' THEN 0 WHEN 'error' THEN 1 WHEN 'warning' THEN 2 ELSE 3 END,
+        created_at DESC`).all(...params).map(this.rowToWarning);
+    }
+    // ============ 관계 ============
+    addRelation(sourceId, targetId, relationType) {
+        this.db.prepare('INSERT OR IGNORE INTO code_entity_relations (source_id, target_id, relation_type) VALUES (?, ?, ?)').run(sourceId, targetId, relationType);
+    }
+    removeRelation(sourceId, targetId, relationType) {
+        this.db.prepare('DELETE FROM code_entity_relations WHERE source_id = ? AND target_id = ? AND relation_type = ?').run(sourceId, targetId, relationType);
+    }
+    getRelations(entityId) {
+        return this.db.prepare(`
+      SELECT r.target_id, e.name as target_name, r.relation_type
+      FROM code_entity_relations r
+      JOIN code_entities e ON e.id = r.target_id
+      WHERE r.source_id = ?
+    `).all(entityId).map(r => ({
+            targetId: r.target_id,
+            targetName: r.target_name,
+            relationType: r.relation_type,
+        }));
+    }
+    // ============ 이슈/메모리 연결 ============
+    linkIssue(entityId, issueId) {
+        const now = new Date().toISOString();
+        this.db.prepare('INSERT OR IGNORE INTO code_entity_issue_links (entity_id, issue_id, linked_at) VALUES (?, ?, ?)').run(entityId, issueId, now);
+        this.addEvent(entityId, 'issue_linked', { newValue: issueId });
+    }
+    unlinkIssue(entityId, issueId) {
+        this.db.prepare('DELETE FROM code_entity_issue_links WHERE entity_id = ? AND issue_id = ?').run(entityId, issueId);
+    }
+    getLinkedIssues(entityId) {
+        return this.db.prepare('SELECT issue_id FROM code_entity_issue_links WHERE entity_id = ? ORDER BY linked_at').all(entityId).map(r => r.issue_id);
+    }
+    /** 이슈 ID로 연결된 엔티티 ID 목록 반환 (역방향 조회) */
+    getEntitiesByIssueId(issueId) {
+        const rows = this.db.prepare('SELECT entity_id FROM code_entity_issue_links WHERE issue_id = ?').all(issueId);
+        const entities = [];
+        for (const row of rows) {
+            const entity = this.getEntity(row.entity_id);
+            if (entity)
+                entities.push(entity);
+        }
+        return entities;
+    }
+    linkMemory(entityId, memoryId) {
+        const now = new Date().toISOString();
+        this.db.prepare('INSERT OR IGNORE INTO code_entity_memory_links (entity_id, memory_id, linked_at) VALUES (?, ?, ?)').run(entityId, memoryId, now);
+        this.addEvent(entityId, 'memory_linked', { newValue: memoryId });
+    }
+    getLinkedMemories(entityId) {
+        return this.db.prepare('SELECT memory_id FROM code_entity_memory_links WHERE entity_id = ? ORDER BY linked_at').all(entityId).map(r => r.memory_id);
+    }
+    // ============ 이벤트 ============
+    addEvent(entityId, type, data) {
+        const id = nanoid(12);
+        const now = new Date().toISOString();
+        this.db.prepare(`
+      INSERT INTO code_entity_events (id, entity_id, type, old_value, new_value, content, actor, created_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(id, entityId, type, data?.oldValue ?? null, data?.newValue ?? null, data?.content ?? null, data?.actor ?? 'system', now);
+        return {
+            id, entityId, type,
+            oldValue: data?.oldValue,
+            newValue: data?.newValue,
+            content: data?.content,
+            actor: data?.actor ?? 'system',
+            createdAt: now,
+        };
+    }
+    getEvents(entityId, limit = 50) {
+        return this.db.prepare('SELECT * FROM code_entity_events WHERE entity_id = ? ORDER BY created_at DESC LIMIT ?').all(entityId, limit).map(this.rowToEvent);
+    }
+    // ============ 특화 쿼리 ============
+    fileBrief(filePath) {
+        const rows = this.db.prepare('SELECT * FROM code_entities WHERE file_path = ? ORDER BY line_start NULLS LAST, name').all(filePath);
+        const entities = this.rowsToEntities(rows);
+        const deprecated = entities.filter(e => e.status === 'deprecated').length;
+        const untested = entities.filter(e => !e.hasTests).length;
+        const warnings = entities.reduce((sum, e) => sum + e.warnings.filter(w => !w.resolved).length, 0);
+        const broken = entities.filter(e => e.status === 'broken').length;
+        const parts = [`${entities.length} entities`];
+        if (deprecated > 0)
+            parts.push(`${deprecated} deprecated`);
+        if (untested > 0)
+            parts.push(`${untested} untested`);
+        if (warnings > 0)
+            parts.push(`${warnings} warnings`);
+        if (broken > 0)
+            parts.push(`${broken} broken`);
+        return {
+            filePath,
+            summary: parts.join(', '),
+            entities,
+        };
+    }
+    deprecatedEntities(projectId) {
+        const where = projectId
+            ? "WHERE status = 'deprecated' AND project_id = ?"
+            : "WHERE status = 'deprecated'";
+        const params = projectId ? [projectId] : [];
+        const rows = this.db.prepare(`SELECT * FROM code_entities ${where} ORDER BY deprecated_at DESC`).all(...params);
+        return this.rowsToEntities(rows);
+    }
+    untestedEntities(projectId) {
+        const where = projectId
+            ? "WHERE has_tests = 0 AND status = 'active' AND project_id = ?"
+            : "WHERE has_tests = 0 AND status = 'active'";
+        const params = projectId ? [projectId] : [];
+        const rows = this.db.prepare(`SELECT * FROM code_entities ${where} ORDER BY
+        CASE risk_level WHEN 'high' THEN 0 WHEN 'medium' THEN 1 ELSE 2 END,
+        complexity_score DESC NULLS LAST`).all(...params);
+        return this.rowsToEntities(rows);
+    }
+    highRiskEntities(projectId) {
+        const where = projectId
+            ? "WHERE risk_level = 'high' AND project_id = ?"
+            : "WHERE risk_level = 'high'";
+        const params = projectId ? [projectId] : [];
+        const rows = this.db.prepare(`SELECT * FROM code_entities ${where} ORDER BY complexity_score DESC NULLS LAST`).all(...params);
+        return this.rowsToEntities(rows);
+    }
+    entitiesByTag(tag, value) {
+        const query = value
+            ? `SELECT e.* FROM code_entities e
+         JOIN code_entity_tags t ON t.entity_id = e.id
+         WHERE t.tag = ? AND t.value = ?`
+            : `SELECT e.* FROM code_entities e
+         JOIN code_entity_tags t ON t.entity_id = e.id
+         WHERE t.tag = ?`;
+        const params = value ? [tag, value] : [tag];
+        const rows = this.db.prepare(query).all(...params);
+        return this.rowsToEntities(rows);
+    }
+    searchEntities(query, limit = 20) {
+        // FTS5 검색 시도
+        let ftsRows = [];
+        try {
+            ftsRows = this.db.prepare(`
+        SELECT e.* FROM code_entities e
+        INNER JOIN code_entities_fts ON code_entities_fts.rowid = e.rowid
+        WHERE code_entities_fts MATCH ?
+        LIMIT ?
+      `).all(query, limit);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            if (!msg.includes('fts5') && !msg.includes('MATCH')) {
+                console.warn('[Registry] searchEntities FTS error:', msg);
+            }
+        }
+        let results = this.rowsToEntities(ftsRows);
+        // FTS 결과가 부족하면 LIKE 폴백 (camelCase, 부분 매칭)
+        if (results.length < limit) {
+            const escapedQuery = query.replace(/[%_]/g, ch => `\\${ch}`);
+            const likePattern = `%${escapedQuery}%`;
+            const existingIds = new Set(results.map(e => e.id));
+            const fallbackRows = this.db.prepare(`
+        SELECT * FROM code_entities
+        WHERE (name LIKE ? ESCAPE '\\' OR qualified_name LIKE ? ESCAPE '\\' OR description LIKE ? ESCAPE '\\' OR notes LIKE ? ESCAPE '\\' OR signature LIKE ? ESCAPE '\\')
+        LIMIT ?
+      `).all(likePattern, likePattern, likePattern, likePattern, likePattern, limit);
+            const fallback = this.rowsToEntities(fallbackRows)
+                .filter(e => !existingIds.has(e.id));
+            results.push(...fallback.slice(0, limit - results.length));
+        }
+        return results;
+    }
+    // ============ 통계 ============
+    getStats(projectId) {
+        const where = projectId ? 'WHERE project_id = ?' : '';
+        const params = projectId ? [projectId] : [];
+        const total = this.db.prepare(`SELECT COUNT(*) as cnt FROM code_entities ${where}`).get(...params).cnt;
+        const byKind = this.db.prepare(`SELECT kind, COUNT(*) as cnt FROM code_entities ${where} GROUP BY kind`).all(...params).map(r => ({ kind: r.kind, count: r.cnt }));
+        const byStatus = this.db.prepare(`SELECT status, COUNT(*) as cnt FROM code_entities ${where} GROUP BY status`).all(...params).map(r => ({ status: r.status, count: r.cnt }));
+        const deprecated = this.db.prepare(`SELECT COUNT(*) as cnt FROM code_entities ${where ? where + " AND" : "WHERE"} status = 'deprecated'`).get(...params).cnt;
+        const untested = this.db.prepare(`SELECT COUNT(*) as cnt FROM code_entities ${where ? where + " AND" : "WHERE"} has_tests = 0 AND status = 'active'`).get(...params).cnt;
+        const highRisk = this.db.prepare(`SELECT COUNT(*) as cnt FROM code_entities ${where ? where + " AND" : "WHERE"} risk_level = 'high'`).get(...params).cnt;
+        const withWarnings = this.db.prepare(projectId
+            ? `SELECT COUNT(DISTINCT w.entity_id) as cnt FROM code_entity_warnings w
+           JOIN code_entities e ON e.id = w.entity_id
+           WHERE w.resolved = 0 AND e.project_id = ?`
+            : `SELECT COUNT(DISTINCT entity_id) as cnt FROM code_entity_warnings WHERE resolved = 0`).get(...params).cnt;
+        return { total, byKind, byStatus, deprecated, untested, highRisk, withWarnings };
+    }
+    // ============ 유틸 ============
+    close() {
+        this.db.close();
+    }
+    /** 단일 엔티티 변환 (개별 서브쿼리 — 단건 조회용) */
+    rowToEntity(row) {
+        const id = row.id;
+        return this.buildEntity(row, this.getTags(id), this.getWarnings(id), this.getLinkedIssues(id), this.getLinkedMemories(id));
+    }
+    /** 배치 엔티티 변환 (N+1 방지 — 리스트 조회용) */
+    rowsToEntities(rows) {
+        if (rows.length === 0)
+            return [];
+        const ids = rows.map(r => r.id);
+        const placeholders = ids.map(() => '?').join(',');
+        // 배치 태그 로딩
+        const tagRows = this.db.prepare(`SELECT entity_id, tag, value FROM code_entity_tags WHERE entity_id IN (${placeholders})`).all(...ids);
+        const tagsByEntity = new Map();
+        for (const r of tagRows) {
+            const list = tagsByEntity.get(r.entity_id) ?? [];
+            list.push({ tag: r.tag, value: r.value ?? undefined });
+            tagsByEntity.set(r.entity_id, list);
+        }
+        // 배치 경고 로딩
+        const warningRows = this.db.prepare(`SELECT * FROM code_entity_warnings WHERE entity_id IN (${placeholders}) ORDER BY created_at DESC`).all(...ids);
+        const warningsByEntity = new Map();
+        for (const r of warningRows) {
+            const list = warningsByEntity.get(r.entity_id) ?? [];
+            list.push(this.rowToWarning(r));
+            warningsByEntity.set(r.entity_id, list);
+        }
+        // 배치 이슈 링크 로딩
+        const issueRows = this.db.prepare(`SELECT entity_id, issue_id FROM code_entity_issue_links WHERE entity_id IN (${placeholders}) ORDER BY linked_at`).all(...ids);
+        const issuesByEntity = new Map();
+        for (const r of issueRows) {
+            const list = issuesByEntity.get(r.entity_id) ?? [];
+            list.push(r.issue_id);
+            issuesByEntity.set(r.entity_id, list);
+        }
+        // 배치 메모리 링크 로딩
+        const memoryRows = this.db.prepare(`SELECT entity_id, memory_id FROM code_entity_memory_links WHERE entity_id IN (${placeholders}) ORDER BY linked_at`).all(...ids);
+        const memorysByEntity = new Map();
+        for (const r of memoryRows) {
+            const list = memorysByEntity.get(r.entity_id) ?? [];
+            list.push(r.memory_id);
+            memorysByEntity.set(r.entity_id, list);
+        }
+        return rows.map(row => this.buildEntity(row, tagsByEntity.get(row.id) ?? [], warningsByEntity.get(row.id) ?? [], issuesByEntity.get(row.id) ?? [], memorysByEntity.get(row.id) ?? []));
+    }
+    buildEntity(row, tags, warnings, linkedIssueIds, linkedMemoryIds) {
+        return {
+            id: row.id,
+            projectId: row.project_id,
+            kind: row.kind,
+            name: row.name,
+            qualifiedName: row.qualified_name,
+            filePath: row.file_path,
+            lineStart: row.line_start ?? undefined,
+            lineEnd: row.line_end ?? undefined,
+            signature: row.signature ?? undefined,
+            status: row.status,
+            deprecatedAt: row.deprecated_at ?? undefined,
+            deprecatedReason: row.deprecated_reason ?? undefined,
+            hasTests: row.has_tests === 1,
+            testFile: row.test_file ?? undefined,
+            author: row.author ?? undefined,
+            maintainer: row.maintainer ?? undefined,
+            complexityScore: row.complexity_score ?? undefined,
+            riskLevel: row.risk_level,
+            description: row.description ?? '',
+            notes: row.notes ?? '',
+            knowledgeNodeId: row.knowledge_node_id ?? undefined,
+            tags,
+            warnings,
+            linkedIssueIds,
+            linkedMemoryIds,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    rowToWarning(row) {
+        return {
+            id: row.id,
+            entityId: row.entity_id,
+            severity: row.severity,
+            category: row.category,
+            message: row.message,
+            resolved: row.resolved === 1,
+            resolvedAt: row.resolved_at ?? undefined,
+            createdAt: row.created_at,
+        };
+    }
+    rowToEvent(row) {
+        return {
+            id: row.id,
+            entityId: row.entity_id,
+            type: row.type,
+            oldValue: row.old_value ?? undefined,
+            newValue: row.new_value ?? undefined,
+            content: row.content ?? undefined,
+            actor: row.actor,
+            createdAt: row.created_at,
+        };
+    }
+}
+// 싱글톤
+let storeInstance = null;
+export function getRegistryStore(dbPath) {
+    if (!storeInstance) {
+        storeInstance = new SqliteRegistryStore(dbPath);
+    }
+    return storeInstance;
+}
+export function closeRegistryStore() {
+    if (storeInstance) {
+        storeInstance.close();
+        storeInstance = null;
+    }
+}
+//# sourceMappingURL=sqliteStore.js.map