maestro-flow 0.5.2 → 0.5.3

package/dist/src/graph/kg/db/migrations.d.ts

@@ -0,0 +1,8 @@
+import type { KgDatabaseConnection } from './connection.js';
+export interface MigrationStep {
+    version: number;
+    description: string;
+    sql: string;
+}
+export declare function applyMigrations(conn: KgDatabaseConnection): void;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/src/graph/kg/db/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../../../../src/graph/kg/db/migrations.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAG5D,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;CACb;AA6ED,wBAAgB,eAAe,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAYhE"}

package/dist/src/graph/kg/db/migrations.js

@@ -0,0 +1,88 @@
+// src/graph/kg/db/migrations.ts — Schema 版本迁移
+import { CREDIBILITY_MIGRATION_SQL } from '../credibility.js';
+const MIGRATIONS = [
+    {
+        version: 1,
+        description: 'Initial CodeGraph-compatible schema',
+        sql: '',
+    },
+    {
+        version: 2,
+        description: 'MaestroGraph unified schema v2 — knowledge extensions + dual FTS5',
+        sql: '',
+    },
+    {
+        version: 3,
+        description: 'Credibility tracking — decay scoring + usage counters',
+        sql: CREDIBILITY_MIGRATION_SQL,
+    },
+    {
+        version: 4,
+        description: 'code_fts adds keywords column for camelCase sub-word search',
+        sql: `
+      -- Drop old triggers and FTS table
+      DROP TRIGGER IF EXISTS nodes_ai;
+      DROP TRIGGER IF EXISTS nodes_ad;
+      DROP TRIGGER IF EXISTS nodes_au;
+      DROP TABLE IF EXISTS code_fts;
+
+      -- Recreate code_fts with keywords column
+      CREATE VIRTUAL TABLE code_fts USING fts5(
+        id, name, qualified_name, docstring, signature, keywords,
+        tokenize = 'unicode61 remove_diacritics 2',
+        content = 'nodes', content_rowid = 'rowid'
+      );
+
+      -- Backfill existing codegraph nodes
+      INSERT INTO code_fts(rowid, id, name, qualified_name, docstring, signature, keywords)
+      SELECT rowid, id, name, qualified_name, docstring, signature, keywords
+      FROM nodes WHERE source_type = 'codegraph';
+
+      -- Recreate triggers with keywords column
+      CREATE TRIGGER nodes_ai AFTER INSERT ON nodes BEGIN
+        INSERT INTO code_fts(rowid, id, name, qualified_name, docstring, signature, keywords)
+        SELECT NEW.rowid, NEW.id, NEW.name, NEW.qualified_name, NEW.docstring, NEW.signature, NEW.keywords
+        WHERE NEW.source_type = 'codegraph';
+        INSERT INTO knowledge_fts(rowid, id, name, definition, body, aliases, keywords)
+        SELECT NEW.rowid, NEW.id, NEW.name, NEW.definition, NEW.body, NEW.aliases, NEW.keywords
+        WHERE NEW.source_type != 'codegraph';
+      END;
+
+      CREATE TRIGGER nodes_ad AFTER DELETE ON nodes BEGIN
+        INSERT INTO code_fts(code_fts, rowid, id, name, qualified_name, docstring, signature, keywords)
+        SELECT 'delete', OLD.rowid, OLD.id, OLD.name, OLD.qualified_name, OLD.docstring, OLD.signature, OLD.keywords
+        WHERE OLD.source_type = 'codegraph';
+        INSERT INTO knowledge_fts(knowledge_fts, rowid, id, name, definition, body, aliases, keywords)
+        SELECT 'delete', OLD.rowid, OLD.id, OLD.name, OLD.definition, OLD.body, OLD.aliases, OLD.keywords
+        WHERE OLD.source_type != 'codegraph';
+      END;
+
+      CREATE TRIGGER nodes_au AFTER UPDATE ON nodes BEGIN
+        INSERT INTO code_fts(code_fts, rowid, id, name, qualified_name, docstring, signature, keywords)
+        SELECT 'delete', OLD.rowid, OLD.id, OLD.name, OLD.qualified_name, OLD.docstring, OLD.signature, OLD.keywords
+        WHERE OLD.source_type = 'codegraph';
+        INSERT INTO code_fts(rowid, id, name, qualified_name, docstring, signature, keywords)
+        SELECT NEW.rowid, NEW.id, NEW.name, NEW.qualified_name, NEW.docstring, NEW.signature, NEW.keywords
+        WHERE NEW.source_type = 'codegraph';
+        INSERT INTO knowledge_fts(knowledge_fts, rowid, id, name, definition, body, aliases, keywords)
+        SELECT 'delete', OLD.rowid, OLD.id, OLD.name, OLD.definition, OLD.body, OLD.aliases, OLD.keywords
+        WHERE OLD.source_type != 'codegraph';
+        INSERT INTO knowledge_fts(rowid, id, name, definition, body, aliases, keywords)
+        SELECT NEW.rowid, NEW.id, NEW.name, NEW.definition, NEW.body, NEW.aliases, NEW.keywords
+        WHERE NEW.source_type != 'codegraph';
+      END;
+    `,
+    },
+];
+export function applyMigrations(conn) {
+    const currentVersion = conn.getSchemaVersion();
+    for (const migration of MIGRATIONS) {
+        if (migration.version > currentVersion) {
+            if (migration.sql) {
+                conn.raw.exec(migration.sql);
+            }
+            conn.raw.prepare('INSERT OR REPLACE INTO schema_versions (version, applied_at, description) VALUES (?, ?, ?)').run(migration.version, Date.now(), migration.description);
+        }
+    }
+}
+//# sourceMappingURL=migrations.js.map

package/dist/src/graph/kg/db/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../../../../src/graph/kg/db/migrations.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAG9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAQ9D,MAAM,UAAU,GAAoB;IAClC;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,qCAAqC;QAClD,GAAG,EAAE,EAAE;KACR;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,mEAAmE;QAChF,GAAG,EAAE,EAAE;KACR;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,uDAAuD;QACpE,GAAG,EAAE,yBAAyB;KAC/B;IACD;QACE,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,6DAA6D;QAC1E,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAoDJ;KACF;CACF,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,IAA0B;IACxD,MAAM,cAAc,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC/C,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,IAAI,SAAS,CAAC,OAAO,GAAG,cAAc,EAAE,CAAC;YACvC,IAAI,SAAS,CAAC,GAAG,EAAE,CAAC;gBAClB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YAC/B,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,OAAO,CACd,4FAA4F,CAC7F,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/src/graph/kg/db/queries.d.ts

@@ -0,0 +1,84 @@
+import type { KgDatabaseConnection } from './connection.js';
+import type { UnifiedNode, UnifiedEdge, FileRecord, UnifiedNodeKind, UnifiedEdgeKind, SourceType, UnifiedGraphStats } from './types.js';
+interface FileRow {
+    path: string;
+    content_hash: string | null;
+    language: string | null;
+    size: number | null;
+    modified_at: number | null;
+    indexed_at: number | null;
+    node_count: number;
+    errors: string | null;
+    source_type: string | null;
+}
+export declare class KgQueryBuilder {
+    private conn;
+    constructor(conn: KgDatabaseConnection);
+    private get db();
+    insertNode(node: UnifiedNode): void;
+    insertNodes(nodes: UnifiedNode[]): number;
+    getNode(id: string): UnifiedNode | null;
+    getNodesByIds(ids: string[]): Map<string, UnifiedNode>;
+    getNodesByKind(kinds: UnifiedNodeKind[]): UnifiedNode[];
+    getNodesByFile(filePath: string): UnifiedNode[];
+    getNodesBySourceType(sourceType: SourceType): UnifiedNode[];
+    deleteNode(id: string): void;
+    deleteNodesBySourceTypeAndFile(sourceType: SourceType, filePath: string): number;
+    deleteNodesBySourceType(sourceType: SourceType): number;
+    insertEdge(edge: UnifiedEdge): void;
+    insertEdges(edges: UnifiedEdge[]): number;
+    getOutgoingEdges(nodeId: string, kind?: UnifiedEdgeKind): UnifiedEdge[];
+    getIncomingEdges(nodeId: string, kind?: UnifiedEdgeKind): UnifiedEdge[];
+    getOutgoingEdgesBatch(nodeIds: string[]): Map<string, UnifiedEdge[]>;
+    getIncomingEdgesBatch(nodeIds: string[]): Map<string, UnifiedEdge[]>;
+    deleteEdgesByProvenanceAndSource(provenance: string, sourcePrefix: string): number;
+    insertUnresolvedRef(ref: {
+        fromNodeId: string;
+        referenceName: string;
+        referenceKind: string;
+        line: number;
+        col: number;
+        filePath: string;
+        language: string;
+        candidates?: string[];
+    }): void;
+    getUnresolvedRefsByFile(filePath: string): Array<{
+        id: number;
+        fromNodeId: string;
+        referenceName: string;
+        referenceKind: string;
+        line: number;
+        col: number;
+        filePath: string;
+        language: string;
+        candidates: string[];
+    }>;
+    deleteUnresolvedRefsByFile(filePath: string): number;
+    upsertFile(record: FileRecord): void;
+    getFile(filePath: string): FileRecord | null;
+    getStaleFiles(): FileRow[];
+    getStats(dbSizeBytes: number): UnifiedGraphStats;
+    searchCodeFTS(query: string, opts: {
+        limit?: number;
+        kinds?: string[];
+        languages?: string[];
+        pathFilters?: string[];
+    }): Array<UnifiedNode & {
+        _bm25Score?: number;
+    }>;
+    searchKnowledgeFTS(query: string, opts: {
+        limit?: number;
+        sourceTypes?: SourceType[];
+    }): Array<UnifiedNode & {
+        _bm25Score?: number;
+    }>;
+    searchUnified(query: string, opts: {
+        limit?: number;
+        sourceTypes?: SourceType[];
+    }): UnifiedNode[];
+    private searchNodesLike;
+    private searchKnowledgeLike;
+}
+export declare function sanitizeFtsQuery(input: string): string;
+export {};
+//# sourceMappingURL=queries.d.ts.map

package/dist/src/graph/kg/db/queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queries.d.ts","sourceRoot":"","sources":["../../../../../src/graph/kg/db/queries.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAC5D,OAAO,KAAK,EACV,WAAW,EAAE,WAAW,EAAE,UAAU,EACpC,eAAe,EAAE,eAAe,EAChC,UAAU,EAAkB,iBAAiB,EAC9C,MAAM,YAAY,CAAC;AAmDpB,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AA+FD,qBAAa,cAAc;IACzB,OAAO,CAAC,IAAI,CAAuB;gBAEvB,IAAI,EAAE,oBAAoB;IAItC,OAAO,KAAK,EAAE,GAEb;IAID,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IASnC,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM;IA4CzC,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAKvC,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC;IAkBtD,cAAc,CAAC,KAAK,EAAE,eAAe,EAAE,GAAG,WAAW,EAAE;IASvD,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE;IAO/C,oBAAoB,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,EAAE;IAO3D,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI5B,8BAA8B,CAAC,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAMhF,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;IAQvD,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI;IAWnC,WAAW,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM;IAoBzC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,WAAW,EAAE;IAavE,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,GAAG,WAAW,EAAE;IAavE,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAmBpE,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAmBpE,gCAAgC,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM;IAQlF,mBAAmB,CAAC,GAAG,EAAE;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,GAAG,IAAI;IAWR,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,KAAK,CAAC;QAC/C,EAAE,EAAE,MAAM,CAAC;QACX,UAAU,EAAE,MAAM,CAAC;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IAeF,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAQpD,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI;IAapC,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAgB5C,aAAa,IAAI,OAAO,EAAE;IAQ1B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,iBAAiB;IAqChD,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,KAAK,CAAC,WAAW,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAuCpK,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;KAAE,GAAG,KAAK,CAAC,WAAW,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAkCrI,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;KAAE,GAAG,WAAW,EAAE;IAOjG,OAAO,CAAC,eAAe;IAkBvB,OAAO,CAAC,mBAAmB;CAa5B;AAqBD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMtD"}

package/dist/src/graph/kg/db/queries.js

@@ -0,0 +1,471 @@
+// src/graph/kg/db/queries.ts — MaestroGraph 统一 CRUD
+// 扩展 CodeGraph QueryBuilder 以支持知识节点 + 双 FTS5
+import { tokenize as camelTokenize } from '../resolution/name-matcher.js';
+function safeJsonParse(str, fallback) {
+    if (!str)
+        return fallback;
+    try {
+        return JSON.parse(str);
+    }
+    catch {
+        return fallback;
+    }
+}
+function rowToNode(row) {
+    return {
+        id: row.id,
+        kind: row.kind,
+        name: row.name,
+        qualifiedName: row.qualified_name ?? '',
+        filePath: row.file_path ?? '',
+        language: (row.language ?? 'unknown'),
+        startLine: row.start_line,
+        endLine: row.end_line,
+        startColumn: row.start_column,
+        endColumn: row.end_column,
+        docstring: row.docstring ?? '',
+        signature: row.signature ?? '',
+        visibility: (row.visibility ?? ''),
+        isExported: Boolean(row.is_exported),
+        isAsync: Boolean(row.is_async),
+        isStatic: Boolean(row.is_static),
+        isAbstract: Boolean(row.is_abstract),
+        decorators: safeJsonParse(row.decorators, []),
+        typeParameters: safeJsonParse(row.type_parameters, []),
+        sourceType: (row.source_type ?? 'codegraph'),
+        definition: row.definition ?? '',
+        aliases: safeJsonParse(row.aliases, []),
+        keywords: safeJsonParse(row.keywords, []),
+        category: row.category ?? '',
+        roles: safeJsonParse(row.roles, []),
+        priority: row.priority ?? '',
+        status: row.status ?? 'active',
+        body: row.body ?? '',
+        metadata: safeJsonParse(row.metadata, {}),
+        updatedAt: row.updated_at,
+    };
+}
+function nodeToRow(node) {
+    return {
+        id: node.id,
+        kind: node.kind,
+        name: node.name,
+        qualified_name: node.qualifiedName,
+        file_path: node.filePath,
+        language: node.language,
+        start_line: node.startLine,
+        end_line: node.endLine,
+        start_column: node.startColumn,
+        end_column: node.endColumn,
+        docstring: node.docstring || null,
+        signature: node.signature || null,
+        visibility: node.visibility || null,
+        is_exported: node.isExported ? 1 : 0,
+        is_async: node.isAsync ? 1 : 0,
+        is_static: node.isStatic ? 1 : 0,
+        is_abstract: node.isAbstract ? 1 : 0,
+        decorators: node.decorators.length > 0 ? JSON.stringify(node.decorators) : null,
+        type_parameters: node.typeParameters.length > 0 ? JSON.stringify(node.typeParameters) : null,
+        source_type: node.sourceType,
+        definition: node.definition || null,
+        aliases: node.aliases.length > 0 ? JSON.stringify(node.aliases) : null,
+        keywords: node.keywords.length > 0 ? JSON.stringify(node.keywords) : null,
+        category: node.category || null,
+        roles: node.roles.length > 0 ? JSON.stringify(node.roles) : null,
+        priority: node.priority || null,
+        status: node.status || null,
+        body: node.body || null,
+        metadata: Object.keys(node.metadata).length > 0 ? JSON.stringify(node.metadata) : null,
+        updated_at: node.updatedAt,
+    };
+}
+function rowToEdge(row) {
+    return {
+        id: row.id,
+        source: row.source,
+        target: row.target,
+        kind: row.kind,
+        metadata: safeJsonParse(row.metadata, {}),
+        line: row.line ?? undefined,
+        column: row.col ?? undefined,
+        provenance: row.provenance,
+    };
+}
+// ---------------------------------------------------------------------------
+// KgQueryBuilder — 统一 CRUD 操作
+// ---------------------------------------------------------------------------
+export class KgQueryBuilder {
+    conn;
+    constructor(conn) {
+        this.conn = conn;
+    }
+    get db() {
+        return this.conn.raw;
+    }
+    // ── Node CRUD ──────────────────────────────────────────────────────
+    insertNode(node) {
+        const row = nodeToRow(node);
+        const cols = Object.keys(row);
+        const placeholders = cols.map(() => '?').join(',');
+        this.db.prepare(`INSERT OR REPLACE INTO nodes (${cols.join(',')}) VALUES (${placeholders})`).run(...cols.map(c => row[c]));
+    }
+    insertNodes(nodes) {
+        if (nodes.length === 0)
+            return 0;
+        const stmt = this.db.prepare(`INSERT OR REPLACE INTO nodes (
+        id, kind, name, qualified_name, file_path, language,
+        start_line, end_line, start_column, end_column,
+        docstring, signature, visibility, is_exported, is_async, is_static, is_abstract,
+        decorators, type_parameters, source_type, definition, aliases, keywords,
+        category, roles, priority, status, body, metadata, updated_at
+      ) VALUES (
+        ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?
+      )`);
+        let count = 0;
+        this.conn.transaction(() => {
+            for (const node of nodes) {
+                let keywords = node.keywords;
+                if (node.sourceType === 'codegraph' && keywords.length === 0) {
+                    const nameTokens = camelTokenize(node.name);
+                    const qnTokens = node.qualifiedName ? camelTokenize(node.qualifiedName.split('.').pop() || '') : [];
+                    const merged = [...new Set([...nameTokens, ...qnTokens])];
+                    if (merged.length > 1)
+                        keywords = merged;
+                }
+                stmt.run(node.id, node.kind, node.name, node.qualifiedName, node.filePath, node.language, node.startLine, node.endLine, node.startColumn, node.endColumn, node.docstring || null, node.signature || null, node.visibility || null, node.isExported ? 1 : 0, node.isAsync ? 1 : 0, node.isStatic ? 1 : 0, node.isAbstract ? 1 : 0, node.decorators.length > 0 ? JSON.stringify(node.decorators) : null, node.typeParameters.length > 0 ? JSON.stringify(node.typeParameters) : null, node.sourceType, node.definition || null, node.aliases.length > 0 ? JSON.stringify(node.aliases) : null, keywords.length > 0 ? JSON.stringify(keywords) : null, node.category || null, node.roles.length > 0 ? JSON.stringify(node.roles) : null, node.priority || null, node.status || null, node.body || null, Object.keys(node.metadata).length > 0 ? JSON.stringify(node.metadata) : null, node.updatedAt);
+                count++;
+            }
+        });
+        return count;
+    }
+    getNode(id) {
+        const row = this.db.prepare('SELECT * FROM nodes WHERE id = ?').get(id);
+        return row ? rowToNode(row) : null;
+    }
+    getNodesByIds(ids) {
+        if (ids.length === 0)
+            return new Map();
+        // 分批查询，每批 500 参数 (D2.3: IN-clause 批量匹配)
+        const BATCH_SIZE = 500;
+        const result = new Map();
+        for (let i = 0; i < ids.length; i += BATCH_SIZE) {
+            const batch = ids.slice(i, i + BATCH_SIZE);
+            const placeholders = batch.map(() => '?').join(',');
+            const rows = this.db.prepare(`SELECT * FROM nodes WHERE id IN (${placeholders})`).all(...batch);
+            for (const row of rows) {
+                result.set(row.id, rowToNode(row));
+            }
+        }
+        return result;
+    }
+    getNodesByKind(kinds) {
+        if (kinds.length === 0)
+            return [];
+        const placeholders = kinds.map(() => '?').join(',');
+        const rows = this.db.prepare(`SELECT * FROM nodes WHERE kind IN (${placeholders})`).all(...kinds);
+        return rows.map(rowToNode);
+    }
+    getNodesByFile(filePath) {
+        const rows = this.db.prepare('SELECT * FROM nodes WHERE file_path = ? ORDER BY start_line').all(filePath);
+        return rows.map(rowToNode);
+    }
+    getNodesBySourceType(sourceType) {
+        const rows = this.db.prepare('SELECT * FROM nodes WHERE source_type = ?').all(sourceType);
+        return rows.map(rowToNode);
+    }
+    deleteNode(id) {
+        this.db.prepare('DELETE FROM nodes WHERE id = ?').run(id);
+    }
+    deleteNodesBySourceTypeAndFile(sourceType, filePath) {
+        return this.db.prepare('DELETE FROM nodes WHERE source_type = ? AND file_path = ?').run(sourceType, filePath).changes;
+    }
+    deleteNodesBySourceType(sourceType) {
+        return this.db.prepare('DELETE FROM nodes WHERE source_type = ?').run(sourceType).changes;
+    }
+    // ── Edge CRUD ──────────────────────────────────────────────────────
+    insertEdge(edge) {
+        this.db.prepare(`INSERT INTO edges (source, target, kind, metadata, line, col, provenance)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`).run(edge.source, edge.target, edge.kind, edge.metadata && Object.keys(edge.metadata).length > 0 ? JSON.stringify(edge.metadata) : null, edge.line ?? null, edge.column ?? null, edge.provenance ?? null);
+    }
+    insertEdges(edges) {
+        if (edges.length === 0)
+            return 0;
+        const stmt = this.db.prepare(`INSERT INTO edges (source, target, kind, metadata, line, col, provenance)
+       VALUES (?, ?, ?, ?, ?, ?, ?)`);
+        let count = 0;
+        this.conn.transaction(() => {
+            for (const edge of edges) {
+                stmt.run(edge.source, edge.target, edge.kind, edge.metadata && Object.keys(edge.metadata).length > 0 ? JSON.stringify(edge.metadata) : null, edge.line ?? null, edge.column ?? null, edge.provenance ?? null);
+                count++;
+            }
+        });
+        return count;
+    }
+    getOutgoingEdges(nodeId, kind) {
+        if (kind) {
+            const rows = this.db.prepare('SELECT * FROM edges WHERE source = ? AND kind = ?').all(nodeId, kind);
+            return rows.map(rowToEdge);
+        }
+        const rows = this.db.prepare('SELECT * FROM edges WHERE source = ?').all(nodeId);
+        return rows.map(rowToEdge);
+    }
+    getIncomingEdges(nodeId, kind) {
+        if (kind) {
+            const rows = this.db.prepare('SELECT * FROM edges WHERE target = ? AND kind = ?').all(nodeId, kind);
+            return rows.map(rowToEdge);
+        }
+        const rows = this.db.prepare('SELECT * FROM edges WHERE target = ?').all(nodeId);
+        return rows.map(rowToEdge);
+    }
+    getOutgoingEdgesBatch(nodeIds) {
+        const result = new Map();
+        if (nodeIds.length === 0)
+            return result;
+        for (const id of nodeIds)
+            result.set(id, []);
+        const BATCH_SIZE = 500;
+        for (let i = 0; i < nodeIds.length; i += BATCH_SIZE) {
+            const batch = nodeIds.slice(i, i + BATCH_SIZE);
+            const placeholders = batch.map(() => '?').join(',');
+            const rows = this.db.prepare(`SELECT * FROM edges WHERE source IN (${placeholders})`).all(...batch);
+            for (const row of rows) {
+                const edge = rowToEdge(row);
+                result.get(edge.source)?.push(edge);
+            }
+        }
+        return result;
+    }
+    getIncomingEdgesBatch(nodeIds) {
+        const result = new Map();
+        if (nodeIds.length === 0)
+            return result;
+        for (const id of nodeIds)
+            result.set(id, []);
+        const BATCH_SIZE = 500;
+        for (let i = 0; i < nodeIds.length; i += BATCH_SIZE) {
+            const batch = nodeIds.slice(i, i + BATCH_SIZE);
+            const placeholders = batch.map(() => '?').join(',');
+            const rows = this.db.prepare(`SELECT * FROM edges WHERE target IN (${placeholders})`).all(...batch);
+            for (const row of rows) {
+                const edge = rowToEdge(row);
+                result.get(edge.target)?.push(edge);
+            }
+        }
+        return result;
+    }
+    deleteEdgesByProvenanceAndSource(provenance, sourcePrefix) {
+        return this.db.prepare("DELETE FROM edges WHERE provenance = ? AND source LIKE ? ESCAPE '\\'").run(provenance, `${escapeLikePattern(sourcePrefix)}%`).changes;
+    }
+    // ── Unresolved Refs CRUD ──────────────────────────────────────────
+    insertUnresolvedRef(ref) {
+        this.db.prepare(`INSERT INTO unresolved_refs (from_node_id, reference_name, reference_kind, line, col, file_path, language, candidates)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?)`).run(ref.fromNodeId, ref.referenceName, ref.referenceKind, ref.line, ref.col, ref.filePath, ref.language, ref.candidates ? JSON.stringify(ref.candidates) : null);
+    }
+    getUnresolvedRefsByFile(filePath) {
+        const rows = this.db.prepare('SELECT * FROM unresolved_refs WHERE file_path = ?').all(filePath);
+        return rows.map(r => ({
+            id: r.id, fromNodeId: r.from_node_id, referenceName: r.reference_name,
+            referenceKind: r.reference_kind, line: r.line, col: r.col,
+            filePath: r.file_path, language: r.language,
+            candidates: safeJsonParse(r.candidates, []),
+        }));
+    }
+    deleteUnresolvedRefsByFile(filePath) {
+        return this.db.prepare('DELETE FROM unresolved_refs WHERE file_path = ?').run(filePath).changes;
+    }
+    // ── File CRUD ──────────────────────────────────────────────────────
+    upsertFile(record) {
+        this.db.prepare(`INSERT OR REPLACE INTO files (path, content_hash, language, size, modified_at, indexed_at, node_count, errors, source_type)
+       VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(record.path, record.contentHash, record.language, record.size, record.modifiedAt, record.indexedAt, record.nodeCount, record.errors.length > 0 ? JSON.stringify(record.errors) : null, record.sourceType);
+    }
+    getFile(filePath) {
+        const row = this.db.prepare('SELECT * FROM files WHERE path = ?').get(filePath);
+        if (!row)
+            return null;
+        return {
+            path: row.path,
+            contentHash: row.content_hash ?? '',
+            language: (row.language ?? 'unknown'),
+            size: row.size ?? 0,
+            modifiedAt: row.modified_at ?? 0,
+            indexedAt: row.indexed_at ?? 0,
+            nodeCount: row.node_count,
+            errors: safeJsonParse(row.errors, []),
+            sourceType: (row.source_type ?? 'codegraph'),
+        };
+    }
+    getStaleFiles() {
+        return this.db.prepare('SELECT * FROM files WHERE modified_at > indexed_at').all();
+    }
+    // ── Stats ──────────────────────────────────────────────────────────
+    getStats(dbSizeBytes) {
+        const nodeCount = this.db.prepare('SELECT COUNT(*) as n FROM nodes').get().n;
+        const edgeCount = this.db.prepare('SELECT COUNT(*) as n FROM edges').get().n;
+        const fileCount = this.db.prepare('SELECT COUNT(*) as n FROM files').get().n;
+        const nodesByKind = {};
+        const kindRows = this.db.prepare('SELECT kind, COUNT(*) as n FROM nodes GROUP BY kind').all();
+        for (const r of kindRows)
+            nodesByKind[r.kind] = r.n;
+        const edgesByKind = {};
+        const edgeKindRows = this.db.prepare('SELECT kind, COUNT(*) as n FROM edges GROUP BY kind').all();
+        for (const r of edgeKindRows)
+            edgesByKind[r.kind] = r.n;
+        const nodesBySourceType = {};
+        const sourceRows = this.db.prepare('SELECT source_type, COUNT(*) as n FROM nodes GROUP BY source_type').all();
+        for (const r of sourceRows)
+            nodesBySourceType[r.source_type] = r.n;
+        const staleCount = this.db.prepare('SELECT COUNT(*) as n FROM files WHERE modified_at > indexed_at').get().n;
+        const stalenessRatio = fileCount > 0 ? staleCount / fileCount : 0;
+        const detectedFrameworks = [];
+        try {
+            const fwStr = this.db.prepare("SELECT value FROM project_metadata WHERE key = 'detected_frameworks'").get();
+            if (fwStr)
+                detectedFrameworks.push(...safeJsonParse(fwStr.value, []));
+        }
+        catch { /* ignore */ }
+        const schemaVersion = this.conn.getSchemaVersion();
+        return {
+            nodeCount, edgeCount, fileCount, dbSizeBytes,
+            nodesByKind, edgesByKind, nodesBySourceType,
+            detectedFrameworks, schemaVersion, stalenessRatio,
+        };
+    }
+    // ── Search — FTS5 统一搜索 (D1.5: 输入消毒) ───────────────────────
+    searchCodeFTS(query, opts) {
+        // CJK 查询降级到 LIKE — unicode61 tokenizer 不支持 CJK 分词
+        if (hasCjkChars(query)) {
+            return this.searchNodesLike(query, opts);
+        }
+        const sanitized = sanitizeFtsQuery(query);
+        if (!sanitized)
+            return [];
+        try {
+            let sql = `
+        SELECT n.*, bm25(code_fts, 0, 20, 5, 1, 2, 10) AS score
+        FROM code_fts JOIN nodes n ON code_fts.id = n.id
+        WHERE code_fts MATCH ? AND n.source_type = 'codegraph'
+      `;
+            const params = [sanitized];
+            if (opts.kinds && opts.kinds.length > 0) {
+                sql += ` AND n.kind IN (${opts.kinds.map(() => '?').join(',')})`;
+                params.push(...opts.kinds);
+            }
+            if (opts.languages && opts.languages.length > 0) {
+                sql += ` AND n.language IN (${opts.languages.map(() => '?').join(',')})`;
+                params.push(...opts.languages);
+            }
+            sql += ` ORDER BY score LIMIT ?`;
+            params.push(opts.limit ?? 20);
+            const rows = this.db.prepare(sql).all(...params);
+            const results = rows.map(r => {
+                const node = rowToNode(r);
+                if (typeof r.score === 'number')
+                    node._bm25Score = -r.score;
+                return node;
+            });
+            if (results.length > 0)
+                return results;
+            return this.searchNodesLike(query, opts);
+        }
+        catch (err) {
+            if (process.env.DEBUG)
+                console.warn('[KG] code FTS5 failed, LIKE fallback:', err);
+            return this.searchNodesLike(query, opts);
+        }
+    }
+    searchKnowledgeFTS(query, opts) {
+        // CJK 短查询降级 (D7.1: trigram 最小单元 3 字符)
+        const isCjkShort = /^[㐀-䶿一-鿿぀-ヿ가-힯]{1,2}$/.test(query.trim());
+        if (isCjkShort) {
+            return this.searchKnowledgeLike(query, opts);
+        }
+        const sanitized = sanitizeFtsQuery(query);
+        if (!sanitized)
+            return [];
+        try {
+            let sql = `
+        SELECT n.*, bm25(knowledge_fts, 0, 20, 10, 1, 15, 10) AS score
+        FROM knowledge_fts JOIN nodes n ON knowledge_fts.id = n.id
+        WHERE knowledge_fts MATCH ? AND n.source_type != 'codegraph'
+      `;
+            const params = [sanitized];
+            if (opts.sourceTypes && opts.sourceTypes.length > 0) {
+                sql += ` AND n.source_type IN (${opts.sourceTypes.map(() => '?').join(',')})`;
+                params.push(...opts.sourceTypes);
+            }
+            sql += ` ORDER BY score LIMIT ?`;
+            params.push(opts.limit ?? 20);
+            const rows = this.db.prepare(sql).all(...params);
+            return rows.map(r => {
+                const node = rowToNode(r);
+                if (typeof r.score === 'number')
+                    node._bm25Score = -r.score;
+                return node;
+            });
+        }
+        catch (err) {
+            if (process.env.DEBUG)
+                console.warn('[KG] knowledge FTS5 failed, LIKE fallback:', err);
+            return this.searchKnowledgeLike(query, opts);
+        }
+    }
+    searchUnified(query, opts) {
+        const codeResults = this.searchCodeFTS(query, { limit: opts.limit ?? 10 });
+        const knowledgeResults = this.searchKnowledgeFTS(query, { limit: opts.limit ?? 10, sourceTypes: opts.sourceTypes });
+        return [...codeResults, ...knowledgeResults];
+    }
+    // LIKE fallback — 当 FTS5 无结果时
+    searchNodesLike(query, opts) {
+        const escaped = escapeLikePattern(query);
+        let sql = `SELECT * FROM nodes WHERE source_type = 'codegraph' AND (name LIKE ? ESCAPE '\\' OR qualified_name LIKE ? ESCAPE '\\' OR docstring LIKE ? ESCAPE '\\' OR signature LIKE ? ESCAPE '\\')`;
+        const params = [`%${escaped}%`, `%${escaped}%`, `%${escaped}%`, `%${escaped}%`];
+        if (opts.kinds && opts.kinds.length > 0) {
+            sql += ` AND kind IN (${opts.kinds.map(() => '?').join(',')})`;
+            params.push(...opts.kinds);
+        }
+        if (opts.languages && opts.languages.length > 0) {
+            sql += ` AND language IN (${opts.languages.map(() => '?').join(',')})`;
+            params.push(...opts.languages);
+        }
+        sql += ` ORDER BY name LIMIT ?`;
+        params.push(opts.limit ?? 20);
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map(rowToNode);
+    }
+    searchKnowledgeLike(query, opts) {
+        const escaped = escapeLikePattern(query);
+        let sql = `SELECT * FROM nodes WHERE source_type != 'codegraph' AND (name LIKE ? ESCAPE '\\' OR definition LIKE ? ESCAPE '\\' OR aliases LIKE ? ESCAPE '\\' OR keywords LIKE ? ESCAPE '\\' OR body LIKE ? ESCAPE '\\')`;
+        const params = [`%${escaped}%`, `%${escaped}%`, `%${escaped}%`, `%${escaped}%`, `%${escaped}%`];
+        if (opts.sourceTypes && opts.sourceTypes.length > 0) {
+            sql += ` AND source_type IN (${opts.sourceTypes.map(() => '?').join(',')})`;
+            params.push(...opts.sourceTypes);
+        }
+        sql += ` ORDER BY name LIMIT ?`;
+        params.push(opts.limit ?? 20);
+        const rows = this.db.prepare(sql).all(...params);
+        return rows.map(rowToNode);
+    }
+}
+// ---------------------------------------------------------------------------
+// LIKE 通配符转义 (AC13)
+// ---------------------------------------------------------------------------
+function escapeLikePattern(input) {
+    return input.replace(/[%_\\]/g, '\\$&');
+}
+// ---------------------------------------------------------------------------
+// FTS5 输入消毒 (D1.5)
+// ---------------------------------------------------------------------------
+function hasCjkChars(input) {
+    return /[㐀-䶿一-鿿぀-ヿ가-힯]/.test(input);
+}
+const FTS5_SPECIAL_CHARS = /[*"(){}[\]:^~+\-!\\]/g;
+const FTS5_OPERATORS = new Set(['and', 'or', 'not', 'near']);
+export function sanitizeFtsQuery(input) {
+    const tokens = input.replace(FTS5_SPECIAL_CHARS, ' ').split(/\s+/)
+        .filter(t => t.length > 0)
+        .filter(t => !FTS5_OPERATORS.has(t.toLowerCase()));
+    if (tokens.length === 0)
+        return '';
+    return tokens.map(t => `"${t.replace(/"/g, '""')}"`).join(' ');
+}
+//# sourceMappingURL=queries.js.map