@jafreck/lore 0.3.7 → 0.3.8

package/dist/server/tools/dependents.js

@@ -0,0 +1,354 @@
+/**
+ * @module lore-server/tools/dependents
+ *
+ * MCP tool: unified reverse-dependency / blast-radius queries.
+ *
+ * Given a symbol name or file path, returns all dependents across edge types
+ * (callers, importers, subclasses, type references) in a single call.
+ * This is a higher-level abstraction over `lore_graph` that resolves names
+ * internally and aggregates across edge kinds.
+ */
+import { getSymbolsByName, getFileByPath, getFileById, } from '../../db/read-only.js';
+// ─── Tool definition ──────────────────────────────────────────────────────────
+export const toolDef = {
+    name: 'lore_dependents',
+    description: 'Find everything affected by changing a symbol or file — unified blast-radius / reverse-dependency query. ' +
+        'Takes a name or path (not a numeric ID) and returns callers, importers, subclasses, and type references in one call. ' +
+        'For kind="symbol", resolves the query to a symbol and returns callers, subclasses, and type-referencers. ' +
+        'For kind="file", resolves the query to a file and returns files that import it plus symbols in other files that call into its symbols. ' +
+        'Set depth > 1 for transitive closure (up to 5 hops). Set compact=true to reduce token count.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Symbol name, class name, or file path to find dependents of.',
+            },
+            kind: {
+                type: 'string',
+                enum: ['symbol', 'file'],
+                description: '"symbol" resolves query as a symbol name; "file" resolves query as a file path.',
+            },
+            depth: {
+                type: 'number',
+                description: 'Transitive hops (default 1, max 5). depth=1 returns direct dependents only. ' +
+                    'depth=N follows dependents N hops deep.',
+                minimum: 1,
+                maximum: 5,
+            },
+            branch: {
+                type: 'string',
+                description: 'Optional branch name to filter results.',
+            },
+            compact: {
+                type: 'boolean',
+                description: 'If true, omit provenance fields (line, character, resolution details) to reduce token count. Default false.',
+            },
+        },
+        required: ['query', 'kind'],
+    },
+};
+// ─── Query helpers ────────────────────────────────────────────────────────────
+function queryCallers(db, symbolIds, branch, limit) {
+    if (symbolIds.length === 0)
+        return [];
+    const placeholders = symbolIds.map(() => '?').join(', ');
+    const conditions = [`sr.callee_id IN (${placeholders})`];
+    const params = [...symbolIds];
+    if (branch !== undefined) {
+        conditions.push('f.branch = ?');
+        params.push(branch);
+    }
+    params.push(limit);
+    return db
+        .prepare(`SELECT sr.caller_id,
+              s.name AS caller_name,
+              s.kind AS caller_kind,
+              f.path AS caller_file,
+              sr.call_line + 1 AS line,
+              CASE WHEN sr.call_character IS NULL THEN NULL ELSE sr.call_character + 1 END AS character,
+              sr.resolution_method
+         FROM symbol_refs sr
+         JOIN symbols s ON s.id = sr.caller_id
+         JOIN files f ON f.id = s.file_id
+        WHERE ${conditions.join(' AND ')}
+        LIMIT ?`)
+        .all(...params);
+}
+function queryImporters(db, fileIds, branch, limit) {
+    if (fileIds.length === 0)
+        return [];
+    const placeholders = fileIds.map(() => '?').join(', ');
+    const conditions = [`fi.resolved_id IN (${placeholders})`];
+    const params = [...fileIds];
+    if (branch !== undefined) {
+        conditions.push('f.branch = ?');
+        params.push(branch);
+    }
+    params.push(limit);
+    return db
+        .prepare(`SELECT fi.file_id,
+              f.path AS file_path,
+              fi.raw_import
+         FROM file_imports fi
+         JOIN files f ON f.id = fi.file_id
+        WHERE ${conditions.join(' AND ')}
+        LIMIT ?`)
+        .all(...params);
+}
+function querySubclasses(db, symbolIds, branch, limit) {
+    if (symbolIds.length === 0)
+        return [];
+    const placeholders = symbolIds.map(() => '?').join(', ');
+    const conditions = [
+        `rel.target_symbol_id IN (${placeholders})`,
+        "rel.relationship_type IN ('extends', 'implements')",
+    ];
+    const params = [...symbolIds];
+    if (branch !== undefined) {
+        conditions.push('f.branch = ?');
+        params.push(branch);
+    }
+    params.push(limit);
+    return db
+        .prepare(`SELECT rel.source_symbol_id AS symbol_id,
+              s.name AS symbol_name,
+              s.kind AS symbol_kind,
+              f.path AS file,
+              rel.relationship_type,
+              CASE WHEN rel.line IS NULL THEN NULL ELSE rel.line + 1 END AS line,
+              CASE WHEN rel.character IS NULL THEN NULL ELSE rel.character + 1 END AS character,
+              rel.resolution_method
+         FROM symbol_relationships rel
+         JOIN symbols s ON s.id = rel.source_symbol_id
+         JOIN files f ON f.id = s.file_id
+        WHERE ${conditions.join(' AND ')}
+        LIMIT ?`)
+        .all(...params);
+}
+function queryTypeReferences(db, symbolIds, branch, limit) {
+    if (symbolIds.length === 0)
+        return [];
+    const placeholders = symbolIds.map(() => '?').join(', ');
+    const conditions = [`tr.type_id IN (${placeholders})`];
+    const params = [...symbolIds];
+    if (branch !== undefined) {
+        conditions.push('f.branch = ?');
+        params.push(branch);
+    }
+    params.push(limit);
+    return db
+        .prepare(`SELECT tr.symbol_id,
+              COALESCE(s.name, '') AS symbol_name,
+              COALESCE(s.kind, '') AS symbol_kind,
+              f.path AS file,
+              tr.ref_kind,
+              tr.ref_line + 1 AS line,
+              CASE WHEN tr.ref_character IS NULL THEN NULL ELSE tr.ref_character + 1 END AS character,
+              tr.resolution_method
+         FROM type_refs tr
+         JOIN files f ON f.id = tr.file_id
+         LEFT JOIN symbols s ON s.id = tr.symbol_id
+        WHERE ${conditions.join(' AND ')}
+        LIMIT ?`)
+        .all(...params);
+}
+/** For kind="file", find all symbols defined in the given file(s) so we can query their callers. */
+function getSymbolIdsInFiles(db, fileIds, branch) {
+    if (fileIds.length === 0)
+        return [];
+    const placeholders = fileIds.map(() => '?').join(', ');
+    const conditions = [`s.file_id IN (${placeholders})`];
+    const params = [...fileIds];
+    if (branch !== undefined) {
+        conditions.push('f.branch = ?');
+        params.push(branch);
+    }
+    const rows = db
+        .prepare(`SELECT s.id
+         FROM symbols s
+         JOIN files f ON f.id = s.file_id
+        WHERE ${conditions.join(' AND ')}`)
+        .all(...params);
+    return rows.map((r) => r.id);
+}
+// ─── Compact helpers ──────────────────────────────────────────────────────────
+function compactCaller(row) {
+    return {
+        caller_id: row.caller_id,
+        caller_name: row.caller_name,
+        caller_kind: row.caller_kind,
+        caller_file: row.caller_file,
+    };
+}
+function compactImporter(row) {
+    return {
+        file_id: row.file_id,
+        file_path: row.file_path,
+    };
+}
+function compactSubclass(row) {
+    return {
+        symbol_id: row.symbol_id,
+        symbol_name: row.symbol_name,
+        symbol_kind: row.symbol_kind,
+        file: row.file,
+        relationship_type: row.relationship_type,
+    };
+}
+function compactTypeRef(row) {
+    return {
+        symbol_id: row.symbol_id,
+        symbol_name: row.symbol_name,
+        symbol_kind: row.symbol_kind,
+        file: row.file,
+        ref_kind: row.ref_kind,
+    };
+}
+// ─── Multi-hop expansion ──────────────────────────────────────────────────────
+function expandCallers(db, seedIds, branch, depth, limit) {
+    const all = [];
+    const seen = new Set();
+    let frontier = seedIds;
+    for (let hop = 0; hop < depth && frontier.length > 0 && all.length < limit; hop++) {
+        const remaining = limit - all.length;
+        const rows = queryCallers(db, frontier, branch, remaining);
+        const nextFrontier = [];
+        for (const row of rows) {
+            if (seen.has(row.caller_id))
+                continue;
+            seen.add(row.caller_id);
+            all.push(row);
+            nextFrontier.push(row.caller_id);
+        }
+        frontier = nextFrontier;
+    }
+    return all;
+}
+function expandImporters(db, seedIds, branch, depth, limit) {
+    const all = [];
+    const seen = new Set();
+    let frontier = seedIds;
+    for (let hop = 0; hop < depth && frontier.length > 0 && all.length < limit; hop++) {
+        const remaining = limit - all.length;
+        const rows = queryImporters(db, frontier, branch, remaining);
+        const nextFrontier = [];
+        for (const row of rows) {
+            if (seen.has(row.file_id))
+                continue;
+            seen.add(row.file_id);
+            all.push(row);
+            nextFrontier.push(row.file_id);
+        }
+        frontier = nextFrontier;
+    }
+    return all;
+}
+function expandSubclasses(db, seedIds, branch, depth, limit) {
+    const all = [];
+    const seen = new Set();
+    let frontier = seedIds;
+    for (let hop = 0; hop < depth && frontier.length > 0 && all.length < limit; hop++) {
+        const remaining = limit - all.length;
+        const rows = querySubclasses(db, frontier, branch, remaining);
+        const nextFrontier = [];
+        for (const row of rows) {
+            if (seen.has(row.symbol_id))
+                continue;
+            seen.add(row.symbol_id);
+            all.push(row);
+            nextFrontier.push(row.symbol_id);
+        }
+        frontier = nextFrontier;
+    }
+    return all;
+}
+// ─── Handler ──────────────────────────────────────────────────────────────────
+const DEFAULT_LIMIT = 200;
+/** Unified reverse-dependency / blast-radius query. */
+export function handler(db, args) {
+    const depth = Math.max(1, Math.min(args.depth ?? 1, 5));
+    const compact = args.compact ?? false;
+    const limit = DEFAULT_LIMIT;
+    if (args.kind === 'file') {
+        return handleFileDependents(db, args, depth, compact, limit);
+    }
+    return handleSymbolDependents(db, args, depth, compact, limit);
+}
+function handleFileDependents(db, args, depth, compact, limit) {
+    const file = getFileByPath(db, args.query, args.branch);
+    if (!file) {
+        return { error: `No file found matching path "${args.query}"` };
+    }
+    const target = {
+        id: file.id,
+        name: file.path,
+        kind: 'file',
+        file: file.path,
+    };
+    // Get importers of this file
+    const importerRows = expandImporters(db, [file.id], args.branch, depth, limit);
+    // Get symbols defined in this file, then find callers from other files
+    const symbolIds = getSymbolIdsInFiles(db, [file.id], args.branch);
+    const callerRows = expandCallers(db, symbolIds, args.branch, depth, limit)
+        // Exclude callers that are within the same file
+        .filter((row) => row.caller_file !== file.path);
+    // For files, subclasses and type_references target symbols within the file
+    const subclassRows = expandSubclasses(db, symbolIds, args.branch, depth, limit);
+    const typeRefRows = queryTypeReferences(db, symbolIds, args.branch, limit);
+    return buildResult(target, callerRows, importerRows, subclassRows, typeRefRows, compact, depth);
+}
+function handleSymbolDependents(db, args, depth, compact, limit) {
+    const symbols = getSymbolsByName(db, args.query, {
+        branch: args.branch,
+        matchMode: 'exact',
+    });
+    if (symbols.length === 0) {
+        return { error: `No symbol found matching name "${args.query}"` };
+    }
+    // If multiple matches, use the first but if many are ambiguous, report
+    if (symbols.length > 5) {
+        return {
+            error: `Ambiguous: ${symbols.length} symbols match "${args.query}". Narrow your query with a more specific name.`,
+            candidates: symbols.slice(0, 10).map((s) => {
+                const file = getFileById(db, s.file_id, args.branch);
+                return { id: s.id, name: s.name, kind: s.kind, file: file?.path ?? '' };
+            }),
+        };
+    }
+    // Use the best match (first result). If there are a few, aggregate across all.
+    const symbolIds = symbols.map((s) => s.id);
+    const primarySymbol = symbols[0];
+    const primaryFile = getFileById(db, primarySymbol.file_id, args.branch);
+    const target = {
+        id: primarySymbol.id,
+        name: primarySymbol.name,
+        kind: primarySymbol.kind,
+        file: primaryFile?.path,
+    };
+    const callerRows = expandCallers(db, symbolIds, args.branch, depth, limit);
+    const subclassRows = expandSubclasses(db, symbolIds, args.branch, depth, limit);
+    const typeRefRows = queryTypeReferences(db, symbolIds, args.branch, limit);
+    // For symbols, importers are files that import the file containing this symbol
+    const fileIds = [...new Set(symbols.map((s) => s.file_id))];
+    const importerRows = expandImporters(db, fileIds, args.branch, depth, limit);
+    return buildResult(target, callerRows, importerRows, subclassRows, typeRefRows, compact, depth);
+}
+function buildResult(target, callerRows, importerRows, subclassRows, typeRefRows, compact, depth) {
+    const callers = compact ? callerRows.map(compactCaller) : callerRows;
+    const importers = compact ? importerRows.map(compactImporter) : importerRows;
+    const subclasses = compact ? subclassRows.map(compactSubclass) : subclassRows;
+    const typeRefs = compact ? typeRefRows.map(compactTypeRef) : typeRefRows;
+    return {
+        target,
+        dependents: {
+            callers,
+            importers,
+            subclasses,
+            type_references: typeRefs,
+        },
+        depth_used: depth,
+        total_count: callers.length + importers.length + subclasses.length + typeRefs.length,
+    };
+}
+//# sourceMappingURL=dependents.js.map

package/dist/server/tools/dependents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependents.js","sourceRoot":"","sources":["../../../src/server/tools/dependents.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACL,gBAAgB,EAChB,aAAa,EAEb,WAAW,GACZ,MAAM,uBAAuB,CAAC;AAE/B,iFAAiF;AAEjF,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,IAAI,EAAE,iBAAiB;IACvB,WAAW,EACT,2GAA2G;QAC3G,uHAAuH;QACvH,2GAA2G;QAC3G,yIAAyI;QACzI,8FAA8F;IAChG,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,8DAA8D;aAC5E;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACxB,WAAW,EACT,iFAAiF;aACpF;YACD,KAAK,EAAE;gBACL,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,8EAA8E;oBAC9E,yCAAyC;gBAC3C,OAAO,EAAE,CAAC;gBACV,OAAO,EAAE,CAAC;aACX;YACD,MAAM,EAAE;gBACN,IAAI,EAAE,QAAQ;gBACd,WAAW,EAAE,yCAAyC;aACvD;YACD,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,WAAW,EACT,6GAA6G;aAChH;SACF;QACD,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;KAC5B;CACO,CAAC;AA8IX,iFAAiF;AAEjF,SAAS,YAAY,CACnB,EAAqB,EACrB,SAAmB,EACnB,MAA0B,EAC1B,KAAa;IAEb,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,CAAC,oBAAoB,YAAY,GAAG,CAAC,CAAC;IACzD,MAAM,MAAM,GAA2B,CAAC,GAAG,SAAS,CAAC,CAAC;IACtD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEnB,OAAO,EAAE;SACN,OAAO,CACN;;;;;;;;;;gBAUU,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;gBACxB,CACX;SACA,GAAG,CAAC,GAAG,MAAM,CAAmB,CAAC;AACtC,CAAC;AAED,SAAS,cAAc,CACrB,EAAqB,EACrB,OAAiB,EACjB,MAA0B,EAC1B,KAAa;IAEb,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,CAAC,sBAAsB,YAAY,GAAG,CAAC,CAAC;IAC3D,MAAM,MAAM,GAA2B,CAAC,GAAG,OAAO,CAAC,CAAC;IACpD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEnB,OAAO,EAAE;SACN,OAAO,CACN;;;;;gBAKU,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;gBACxB,CACX;SACA,GAAG,CAAC,GAAG,MAAM,CAAqB,CAAC;AACxC,CAAC;AAED,SAAS,eAAe,CACtB,EAAqB,EACrB,SAAmB,EACnB,MAA0B,EAC1B,KAAa;IAEb,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG;QACjB,4BAA4B,YAAY,GAAG;QAC3C,oDAAoD;KACrD,CAAC;IACF,MAAM,MAAM,GAA2B,CAAC,GAAG,SAAS,CAAC,CAAC;IACtD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEnB,OAAO,EAAE;SACN,OAAO,CACN;;;;;;;;;;;gBAWU,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;gBACxB,CACX;SACA,GAAG,CAAC,GAAG,MAAM,CAAqB,CAAC;AACxC,CAAC;AAED,SAAS,mBAAmB,CAC1B,EAAqB,EACrB,SAAmB,EACnB,MAA0B,EAC1B,KAAa;IAEb,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACtC,MAAM,YAAY,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,UAAU,GAAG,CAAC,kBAAkB,YAAY,GAAG,CAAC,CAAC;IACvD,MAAM,MAAM,GAA2B,CAAC,GAAG,SAAS,CAAC,CAAC;IACtD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAEnB,OAAO,EAAE;SACN,OAAO,CACN;;;;;;;;;;;gBAWU,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;gBACxB,CACX;SACA,GAAG,CAAC,GAAG,MAAM,CAAoB,CAAC;AACvC,CAAC;AAED,oGAAoG;AACpG,SAAS,mBAAmB,CAC1B,EAAqB,EACrB,OAAiB,EACjB,MAA0B;IAE1B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvD,MAAM,UAAU,GAAG,CAAC,iBAAiB,YAAY,GAAG,CAAC,CAAC;IACtD,MAAM,MAAM,GAA2B,CAAC,GAAG,OAAO,CAAC,CAAC;IACpD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CACN;;;gBAGU,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CACrC;SACA,GAAG,CAAC,GAAG,MAAM,CAA0B,CAAC;IAE3C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC/B,CAAC;AAED,iFAAiF;AAEjF,SAAS,aAAa,CAAC,GAAiB;IACtC,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;KAC7B,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,GAAmB;IAC1C,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,SAAS,EAAE,GAAG,CAAC,SAAS;KACzB,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,GAAmB;IAC1C,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;KACzC,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,GAAkB;IACxC,OAAO;QACL,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,QAAQ,EAAE,GAAG,CAAC,QAAQ;KACvB,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF,SAAS,aAAa,CACpB,EAAqB,EACrB,OAAiB,EACjB,MAA0B,EAC1B,KAAa,EACb,KAAa;IAEb,MAAM,GAAG,GAAmB,EAAE,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,QAAQ,GAAG,OAAO,CAAC;IAEvB,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,KAAK,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;QAClF,MAAM,SAAS,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC;QACrC,MAAM,IAAI,GAAG,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC3D,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,SAAS;YACtC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACxB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACd,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;QACD,QAAQ,GAAG,YAAY,CAAC;IAC1B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,eAAe,CACtB,EAAqB,EACrB,OAAiB,EACjB,MAA0B,EAC1B,KAAa,EACb,KAAa;IAEb,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,QAAQ,GAAG,OAAO,CAAC;IAEvB,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,KAAK,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;QAClF,MAAM,SAAS,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC;QACrC,MAAM,IAAI,GAAG,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC7D,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC;gBAAE,SAAS;YACpC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;YACtB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACd,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;QACD,QAAQ,GAAG,YAAY,CAAC;IAC1B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,gBAAgB,CACvB,EAAqB,EACrB,OAAiB,EACjB,MAA0B,EAC1B,KAAa,EACb,KAAa;IAEb,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,IAAI,QAAQ,GAAG,OAAO,CAAC;IAEvB,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,KAAK,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC;QAClF,MAAM,SAAS,GAAG,KAAK,GAAG,GAAG,CAAC,MAAM,CAAC;QACrC,MAAM,IAAI,GAAG,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QAC9D,MAAM,YAAY,GAAa,EAAE,CAAC;QAClC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC;gBAAE,SAAS;YACtC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACxB,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACd,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACnC,CAAC;QACD,QAAQ,GAAG,YAAY,CAAC;IAC1B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iFAAiF;AAEjF,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B,uDAAuD;AACvD,MAAM,UAAU,OAAO,CACrB,EAAqB,EACrB,IAAoB;IAEpB,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;IACtC,MAAM,KAAK,GAAG,aAAa,CAAC;IAE5B,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QACzB,OAAO,oBAAoB,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,sBAAsB,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,SAAS,oBAAoB,CAC3B,EAAqB,EACrB,IAAoB,EACpB,KAAa,EACb,OAAgB,EAChB,KAAa;IAEb,MAAM,IAAI,GAAG,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACxD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,KAAK,EAAE,gCAAgC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IAClE,CAAC;IAED,MAAM,MAAM,GAAoB;QAC9B,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;IAEF,6BAA6B;IAC7B,MAAM,YAAY,GAAG,eAAe,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAE/E,uEAAuE;IACvE,MAAM,SAAS,GAAG,mBAAmB,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAClE,MAAM,UAAU,GAAG,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC;QACxE,gDAAgD;SAC/C,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;IAElD,2EAA2E;IAC3E,MAAM,YAAY,GAAG,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAChF,MAAM,WAAW,GAAG,mBAAmB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAE3E,OAAO,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAClG,CAAC;AAED,SAAS,sBAAsB,CAC7B,EAAqB,EACrB,IAAoB,EACpB,KAAa,EACb,OAAgB,EAChB,KAAa;IAEb,MAAM,OAAO,GAAG,gBAAgB,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,EAAE;QAC/C,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,SAAS,EAAE,OAAO;KACnB,CAAC,CAAC;IAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,kCAAkC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;IACpE,CAAC;IAED,uEAAuE;IACvE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,KAAK,EAAE,cAAc,OAAO,CAAC,MAAM,mBAAmB,IAAI,CAAC,KAAK,iDAAiD;YACjH,UAAU,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACzC,MAAM,IAAI,GAAG,WAAW,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;gBACrD,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,EAAE,EAAE,CAAC;YAC1E,CAAC,CAAC;SACH,CAAC;IACJ,CAAC;IAED,+EAA+E;IAC/E,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC3C,MAAM,aAAa,GAAG,OAAO,CAAC,CAAC,CAAE,CAAC;IAClC,MAAM,WAAW,GAAG,WAAW,CAAC,EAAE,EAAE,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAExE,MAAM,MAAM,GAAoB;QAC9B,EAAE,EAAE,aAAa,CAAC,EAAE;QACpB,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,IAAI,EAAE,WAAW,EAAE,IAAI;KACxB,CAAC;IAEF,MAAM,UAAU,GAAG,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAC3E,MAAM,YAAY,GAAG,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAChF,MAAM,WAAW,GAAG,mBAAmB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAE3E,+EAA+E;IAC/E,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5D,MAAM,YAAY,GAAG,eAAe,CAAC,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IAE7E,OAAO,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC;AAClG,CAAC;AAED,SAAS,WAAW,CAClB,MAAuB,EACvB,UAA0B,EAC1B,YAA8B,EAC9B,YAA8B,EAC9B,WAA4B,EAC5B,OAAgB,EAChB,KAAa;IAEb,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC;IACrE,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAC7E,MAAM,UAAU,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC;IAC9E,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;IAEzE,OAAO;QACL,MAAM;QACN,UAAU,EAAE;YACV,OAAO;YACP,SAAS;YACT,UAAU;YACV,eAAe,EAAE,QAAQ;SAC1B;QACD,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM;KACrF,CAAC;AACJ,CAAC"}

package/dist/server/tools/diff.d.ts

@@ -0,0 +1,73 @@
+/**
+ * @module lore-server/tools/diff
+ *
+ * MCP tool: compare exported symbols between two indexed branches.
+ */
+import type { Database } from '../../db/read-only.js';
+export declare const toolDef: {
+    readonly name: "lore_diff";
+    readonly description: string;
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly old_branch: {
+                readonly type: "string";
+                readonly description: "The baseline branch to diff from.";
+            };
+            readonly new_branch: {
+                readonly type: "string";
+                readonly description: "The target branch to diff to. Defaults to the most recently indexed branch.";
+            };
+            readonly path_prefix: {
+                readonly type: "string";
+                readonly description: "Limit results to files whose path starts with this prefix.";
+            };
+            readonly kind: {
+                readonly type: "string";
+                readonly description: "Limit results to symbols of this kind (e.g. \"function\", \"class\").";
+            };
+            readonly limit: {
+                readonly type: "integer";
+                readonly description: "Max entries per result array (default 50, max 500).";
+                readonly minimum: 1;
+                readonly maximum: 500;
+            };
+        };
+        readonly required: readonly ["old_branch"];
+    };
+};
+export interface DiffArgs {
+    old_branch: string;
+    new_branch?: string;
+    path_prefix?: string;
+    kind?: string;
+    limit?: number;
+}
+export interface DiffEntry {
+    name: string;
+    kind: string;
+    file_path: string;
+    signature: string | null;
+}
+export interface ChangedEntry {
+    name: string;
+    kind: string;
+    file_path: string;
+    old_signature: string | null;
+    new_signature: string | null;
+}
+export interface DiffResult {
+    old_branch: string;
+    new_branch: string;
+    added: DiffEntry[];
+    removed: DiffEntry[];
+    changed: ChangedEntry[];
+    summary: {
+        added_count: number;
+        removed_count: number;
+        changed_count: number;
+    };
+}
+/** Compare exported symbols between two indexed branches. */
+export declare function handler(db: Database.Database, args: DiffArgs): DiffResult;
+//# sourceMappingURL=diff.d.ts.map

package/dist/server/tools/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../../src/server/tools/diff.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAItD,eAAO,MAAM,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCV,CAAC;AAIX,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAID,6DAA6D;AAC7D,wBAAgB,OAAO,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,CA0GzE"}

package/dist/server/tools/diff.js

@@ -0,0 +1,157 @@
+/**
+ * @module lore-server/tools/diff
+ *
+ * MCP tool: compare exported symbols between two indexed branches.
+ */
+// ─── Tool definition ──────────────────────────────────────────────────────────
+export const toolDef = {
+    name: 'lore_diff',
+    description: 'Compare exported symbols between two indexed branches. ' +
+        'Returns added, removed, and changed (signature-different) symbols.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            old_branch: {
+                type: 'string',
+                description: 'The baseline branch to diff from.',
+            },
+            new_branch: {
+                type: 'string',
+                description: 'The target branch to diff to. Defaults to the most recently indexed branch.',
+            },
+            path_prefix: {
+                type: 'string',
+                description: 'Limit results to files whose path starts with this prefix.',
+            },
+            kind: {
+                type: 'string',
+                description: 'Limit results to symbols of this kind (e.g. "function", "class").',
+            },
+            limit: {
+                type: 'integer',
+                description: 'Max entries per result array (default 50, max 500).',
+                minimum: 1,
+                maximum: 500,
+            },
+        },
+        required: ['old_branch'],
+    },
+};
+// ─── Handler ──────────────────────────────────────────────────────────────────
+/** Compare exported symbols between two indexed branches. */
+export function handler(db, args) {
+    const oldBranch = args.old_branch;
+    const newBranch = args.new_branch ?? resolveDefaultBranch(db, oldBranch);
+    const limit = Math.min(Math.max(1, args.limit ?? 50), 500);
+    const filterClauses = [];
+    const filterParams = [];
+    // Separate filter clauses for the changed query which uses different aliases
+    const changedFilterClauses = [];
+    const changedFilterParams = [];
+    if (args.path_prefix) {
+        const prefixPattern = escapeLikePrefix(args.path_prefix);
+        filterClauses.push('AND f.path LIKE ? ESCAPE \'\\\'');
+        filterParams.push(prefixPattern);
+        changedFilterClauses.push('AND f_new.path LIKE ? ESCAPE \'\\\'');
+        changedFilterParams.push(prefixPattern);
+    }
+    if (args.kind) {
+        filterClauses.push('AND s.kind = ?');
+        filterParams.push(args.kind);
+        changedFilterClauses.push('AND s_new.kind = ?');
+        changedFilterParams.push(args.kind);
+    }
+    const filters = filterClauses.join(' ');
+    const changedFilters = changedFilterClauses.join(' ');
+    // Added: exported symbols in new_branch not present in old_branch
+    const added = db.prepare(`SELECT s.name, s.kind, f.path AS file_path, s.signature
+       FROM symbols s
+       JOIN files f ON f.id = s.file_id
+      WHERE f.branch = ?
+        AND s.is_exported = 1
+        ${filters}
+        AND NOT EXISTS (
+          SELECT 1
+            FROM symbols s2
+            JOIN files f2 ON f2.id = s2.file_id
+           WHERE f2.branch = ?
+             AND s2.name = s.name
+             AND s2.kind = s.kind
+             AND f2.path = f.path
+             AND s2.is_exported = 1
+        )
+      ORDER BY f.path, s.name
+      LIMIT ?`).all(newBranch, ...filterParams, oldBranch, limit);
+    // Removed: exported symbols in old_branch not present in new_branch
+    const removed = db.prepare(`SELECT s.name, s.kind, f.path AS file_path, s.signature
+       FROM symbols s
+       JOIN files f ON f.id = s.file_id
+      WHERE f.branch = ?
+        AND s.is_exported = 1
+        ${filters}
+        AND NOT EXISTS (
+          SELECT 1
+            FROM symbols s2
+            JOIN files f2 ON f2.id = s2.file_id
+           WHERE f2.branch = ?
+             AND s2.name = s.name
+             AND s2.kind = s.kind
+             AND f2.path = f.path
+             AND s2.is_exported = 1
+        )
+      ORDER BY f.path, s.name
+      LIMIT ?`).all(oldBranch, ...filterParams, newBranch, limit);
+    // Changed: same name/kind/path but different signature across branches
+    const changed = db.prepare(`SELECT s_new.name,
+            s_new.kind,
+            f_new.path AS file_path,
+            s_old.signature AS old_signature,
+            s_new.signature AS new_signature
+       FROM symbols s_new
+       JOIN files f_new ON f_new.id = s_new.file_id
+       JOIN files f_old ON f_old.path = f_new.path AND f_old.branch = ?
+       JOIN symbols s_old ON s_old.file_id = f_old.id
+                         AND s_old.name = s_new.name
+                         AND s_old.kind = s_new.kind
+                         AND s_old.is_exported = 1
+      WHERE f_new.branch = ?
+        AND s_new.is_exported = 1
+        ${changedFilters}
+        AND COALESCE(s_new.signature, '') != COALESCE(s_old.signature, '')
+      ORDER BY f_new.path, s_new.name
+      LIMIT ?`).all(oldBranch, newBranch, ...changedFilterParams, limit);
+    return {
+        old_branch: oldBranch,
+        new_branch: newBranch,
+        added,
+        removed,
+        changed,
+        summary: {
+            added_count: added.length,
+            removed_count: removed.length,
+            changed_count: changed.length,
+        },
+    };
+}
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/**
+ * Resolve the default new_branch by picking the most recently indexed branch
+ * from the files table that is different from old_branch.
+ */
+function resolveDefaultBranch(db, oldBranch) {
+    const row = db.prepare(`SELECT branch FROM files
+      WHERE branch != ?
+      ORDER BY indexed_at DESC
+      LIMIT 1`).get(oldBranch);
+    if (!row) {
+        throw new Error(`Cannot resolve new_branch: no other indexed branch found besides '${oldBranch}'. ` +
+            'Please specify new_branch explicitly.');
+    }
+    return row.branch;
+}
+/** Escape a path prefix for use with LIKE … ESCAPE '\\'. */
+function escapeLikePrefix(prefix) {
+    const escaped = prefix.replace(/\\/g, '\\\\').replace(/%/g, '\\%').replace(/_/g, '\\_');
+    return escaped + '%';
+}
+//# sourceMappingURL=diff.js.map

package/dist/server/tools/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../../src/server/tools/diff.ts"],"names":[],"mappings":"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"}