@monoes/monomindcli 2.8.4 → 2.9.2

package/dist/src/mcp-tools/monograph/query-tools.js

@@ -0,0 +1,500 @@
+import { getProjectCwd } from '../types.js';
+import { getDbPath, _isValidDb, text, applyPprRerank, computeCommitsBehind, triggerBackgroundBuildIfNeeded, STALENESS_THRESHOLD, preferSymbolHits } from './shared.js';
+// ── monograph_query ───────────────────────────────────────────────────────────
+export const monographQueryTool = {
+    name: 'monograph_query',
+    description: 'BM25 keyword search across the code knowledge graph. When MONOGRAPH_EMBEDDINGS=true uses hybrid BM25+vector ranking (RRF). Returns nodes with file path and line number.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: { type: 'string', description: 'Search terms' },
+            limit: { type: 'number', description: 'Max results (default 20)' },
+            label: { type: 'string', description: 'Filter by node type: Class, Function, Method, etc.' },
+            rerank: { type: 'boolean', description: 'Apply HippoRAG-style PPR graph reranking to boost neighbors of top hits (default: true)' },
+            damping: { type: 'number', description: 'PPR damping factor when rerank=true (0-1, default 0.5)' },
+        },
+        required: ['query'],
+    },
+    handler: async (input) => {
+        const dbPath = getDbPath();
+        if (!_isValidDb(dbPath))
+            return text('Monograph index not built yet. Run monograph_build first.');
+        const { openDb, closeDb, ftsSearch } = await import('@monoes/monograph');
+        const { hybridQuery } = await import('@monoes/monograph');
+        const db = openDb(dbPath);
+        try {
+            // Cap limit: passed directly to SQLite queries and hybridQuery; an
+            // unlimited value saturates memory with rows.
+            const MAX_QUERY_LIMIT = 1_000;
+            const rawLimit = input.limit ?? 20;
+            const limit = Number.isFinite(rawLimit) && rawLimit > 0
+                ? Math.min(Math.floor(rawLimit), MAX_QUERY_LIMIT)
+                : 20;
+            // Cap query: passed to FTS5 and hybridQuery; very long queries waste
+            // parse time and can stress the FTS tokenizer.
+            const MAX_MONOGRAPH_QUERY_LEN = 16 * 1024;
+            const rawQuery = input.query;
+            const query = typeof rawQuery === 'string' && rawQuery.length > MAX_MONOGRAPH_QUERY_LEN
+                ? rawQuery.slice(0, MAX_MONOGRAPH_QUERY_LEN)
+                : rawQuery;
+            const label = input.label;
+            const rerank = input.rerank ?? true;
+            const damping = input.damping ?? 0.5;
+            const zeroResultHint = /\s/.test(query) && !/[A-Z]/.test(query.replace(/\s+/g, '').slice(1))
+                ? ' Hint: monograph indexes identifiers and filenames — try camelCase/PascalCase (e.g. "AgentSpawn") or a filename instead of a phrase.'
+                : '';
+            // Lightweight staleness check — fire-and-forget background rebuild;
+            // append warning to results so the agent knows data may be outdated.
+            let stalenessNote = '';
+            const repoPath = getProjectCwd();
+            const staleness = await computeCommitsBehind(repoPath);
+            if (staleness && staleness.commitsBehind > 0) {
+                const triggered = triggerBackgroundBuildIfNeeded(repoPath, staleness.commitsBehind);
+                stalenessNote = `\n⚠ Index is ${staleness.commitsBehind} commit(s) behind HEAD${triggered ? ' — rebuild triggered' : ''}.`;
+            }
+            if (process.env['MONOGRAPH_EMBEDDINGS'] === 'true') {
+                const results = await hybridQuery(db, query, { limit: rerank ? limit * 2 : limit, label });
+                if (results.length === 0)
+                    return text('No results found.' + zeroResultHint + stalenessNote);
+                if (rerank) {
+                    const seeds = results.map(r => ({
+                        id: r.id, name: r.name ?? r.id, label: r.label ?? '?',
+                        filePath: r.filePath ?? '', startLine: r.startLine ?? null,
+                        score: r.score,
+                    }));
+                    const reranked = applyPprRerank(db, seeds, damping, limit);
+                    const lines = reranked.map(r => {
+                        const loc = r.filePath ? (r.startLine != null ? `${r.filePath}:${r.startLine}` : r.filePath) : '';
+                        const tag = r.boostedByNeighbors ? ' [PPR-boosted]' : '';
+                        return `[${r.label}] ${r.name}  ${loc}  (score: ${r.score.toFixed(4)})${tag}`;
+                    });
+                    return text(lines.join('\n') + stalenessNote);
+                }
+                const lines = results.map(r => {
+                    const loc = r.filePath ? (r.startLine != null ? `${r.filePath}:${r.startLine}` : r.filePath) : '';
+                    return `[${r.label ?? '?'}] ${r.name ?? r.id}  ${loc}  (score: ${r.score.toFixed(4)})`;
+                });
+                return text(lines.join('\n') + stalenessNote);
+            }
+            const results = ftsSearch(db, query, rerank ? limit * 2 : limit, label);
+            if (results.length === 0)
+                return text('No results found.' + zeroResultHint + stalenessNote);
+            if (rerank) {
+                const seeds = results.map(r => ({
+                    id: r.id, name: r.name, label: r.label,
+                    filePath: r.filePath ?? '', startLine: r.startLine ?? null,
+                    score: Math.abs(r.rank),
+                }));
+                const reranked = applyPprRerank(db, seeds, damping, limit);
+                const lines = reranked.map(r => {
+                    const loc = r.filePath ? (r.startLine != null ? `${r.filePath}:${r.startLine}` : r.filePath) : '';
+                    const tag = r.boostedByNeighbors ? ' [PPR-boosted]' : '';
+                    return `[${r.label}] ${r.name}  ${loc}  (score: ${r.score.toFixed(3)})${tag}`;
+                });
+                return text(lines.join('\n') + stalenessNote);
+            }
+            const lines = results.map(r => {
+                const loc = r.filePath ? (r.startLine != null ? `${r.filePath}:${r.startLine}` : r.filePath) : '';
+                return `[${r.label}] ${r.name}  ${loc}  (score: ${r.rank.toFixed(3)})`;
+            });
+            return text(lines.join('\n') + stalenessNote);
+        }
+        finally {
+            closeDb(db);
+        }
+    },
+};
+// ── monograph_suggest ─────────────────────────────────────────────────────────
+export const monographSuggestTool = {
+    name: 'monograph_suggest',
+    description: 'Get graph-topology-derived questions to explore the codebase. Pass task= to score by task relevance via BM25/FTS5.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            task: { type: 'string', description: 'Optional task description for task-relevance scoring' },
+            limit: { type: 'number', description: 'Max questions (default 10)' },
+            checkStaleness: { type: 'boolean', description: 'Check index staleness first and trigger a background rebuild when the index is behind HEAD. Appends a _staleness annotation to the result. (default true — pass false to skip the git check)' },
+        },
+    },
+    handler: async (input) => {
+        // Health-aware mode (formerly monograph_suggest_auto): check staleness and
+        // trigger a background rebuild if the index is behind HEAD. Defaults on
+        // (opt-out, not opt-in) — a caller that never checked was exactly how a
+        // stale graph kept serving results silently.
+        let stalenessAnnotation = '';
+        if (input.checkStaleness !== false) {
+            const repoPath = getProjectCwd();
+            const stalenessResult = await computeCommitsBehind(repoPath);
+            const commitsBehind = stalenessResult?.commitsBehind ?? 0;
+            const triggered = triggerBackgroundBuildIfNeeded(repoPath, commitsBehind, STALENESS_THRESHOLD + 1);
+            const status = triggered ? 'building' : commitsBehind === 0 ? 'fresh' : 'stale';
+            stalenessAnnotation = `\n_staleness: ${JSON.stringify({ commitsBehind, status, triggered })}`;
+        }
+        const dbPath = getDbPath();
+        if (!_isValidDb(dbPath))
+            return text('Monograph index not built yet. Run monograph_build first.' + stalenessAnnotation);
+        const { openDb, closeDb } = await import('@monoes/monograph');
+        const { hybridQuery } = await import('@monoes/monograph');
+        const db = openDb(dbPath);
+        try {
+            // Cap limit and task: limit is passed directly to SQL LIMIT clause;
+            // task is forwarded to hybridQuery (embedding path) or FTS.
+            const MAX_SUGGEST_LIMIT = 1_000;
+            const MAX_SUGGEST_TASK_LEN = 16 * 1024;
+            const rawSuggestLimit = input.limit ?? 10;
+            const limit = Number.isFinite(rawSuggestLimit) && rawSuggestLimit > 0
+                ? Math.min(Math.floor(rawSuggestLimit), MAX_SUGGEST_LIMIT)
+                : 10;
+            const rawTask = input.task ?? '';
+            const task = typeof rawTask === 'string' && rawTask.length > MAX_SUGGEST_TASK_LEN
+                ? rawTask.slice(0, MAX_SUGGEST_TASK_LEN)
+                : rawTask;
+            // Format a suggestion row as a navigable string for LLM consumption.
+            // Includes file:line references so the LLM can jump directly to the code.
+            const formatSuggestion = (r) => {
+                const srcLoc = r.src_file ? (r.src_line != null ? `${r.src_file}:${r.src_line}` : r.src_file) : '';
+                const tgtLoc = r.tgt_file ? (r.tgt_line != null ? `${r.tgt_file}:${r.tgt_line}` : r.tgt_file) : '';
+                const locHint = srcLoc ? `  [${srcLoc}${tgtLoc ? ` → ${tgtLoc}` : ''}]` : '';
+                return `Why does ${r.src} ${r.relation.toLowerCase()} ${r.tgt}? (${r.confidence})${locHint}`;
+            };
+            // When a task is provided, use BM25/FTS5 (via hybridQuery) to find
+            // relevant nodes and restrict the edge-level questions to them. This
+            // used to be gated behind MONOGRAPH_EMBEDDINGS=true, but hybridQuery
+            // is BM25-only now (the embeddings table stayed empty in practice —
+            // see hybrid-query.ts) so the env var gated nothing and just left this
+            // better-ranked path off unless a caller happened to know about it.
+            let hitIds = [];
+            if (task) {
+                const hits = await hybridQuery(db, task, { limit: 20 });
+                const { SYMBOL_NODE_LABELS } = await import('@monoes/monograph');
+                const relevantHits = preferSymbolHits(hits, SYMBOL_NODE_LABELS);
+                hitIds = [...new Set(relevantHits.map(h => h.id))];
+                if (hitIds.length === 0) {
+                    return text('No suggestions for this task. Run monograph_build first or try a different query.' + stalenessAnnotation);
+                }
+            }
+            const taskFilter = hitIds.length
+                ? `AND (e.source_id IN (${hitIds.map(() => '?').join(',')}) OR e.target_id IN (${hitIds.map(() => '?').join(',')}))`
+                : '';
+            const rows = db.prepare(`
+        SELECT e.relation, e.confidence, n1.name as src, n2.name as tgt,
+               n1.file_path as src_file, n1.start_line as src_line,
+               n2.file_path as tgt_file, n2.start_line as tgt_line
+        FROM edges e
+        JOIN nodes n1 ON n1.id = e.source_id
+        JOIN nodes n2 ON n2.id = e.target_id
+        WHERE e.confidence IN ('AMBIGUOUS', 'INFERRED')
+        ${taskFilter}
+        LIMIT 100
+      `).all(...hitIds, ...hitIds);
+            const questions = rows.map(formatSuggestion);
+            const fallback = task ? 'No suggestions for this task. Run monograph_build first.' : 'No suggestions. Run monograph_build first.';
+            return text((questions.slice(0, limit).join('\n') || fallback) + stalenessAnnotation);
+        }
+        finally {
+            closeDb(db);
+        }
+    },
+};
+// ── monograph_context ─────────────────────────────────────────────────────────
+export const monographContextTool = {
+    name: 'monograph_context',
+    description: '360° symbol view: callers, callees, imports, importedBy, community, and containing processes for a symbol.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: { type: 'string', description: 'Symbol name to look up' },
+            filePath: { type: 'string', description: 'Optional file path to disambiguate' },
+        },
+        required: ['name'],
+    },
+    handler: async (input) => {
+        const { openDb, closeDb } = await import('@monoes/monograph');
+        const { getMonographContext } = await import('@monoes/monograph');
+        const db = openDb(getDbPath());
+        try {
+            // Cap name and filePath: forwarded to parameterized SQL via getMonographContext.
+            // Very long strings waste memory before the query even executes.
+            const MAX_CTX_NAME_LEN = 512;
+            const MAX_CTX_PATH_LEN = 4 * 1024;
+            const rawCtxName = input.name;
+            const ctxName = typeof rawCtxName === 'string' && rawCtxName.length > MAX_CTX_NAME_LEN
+                ? rawCtxName.slice(0, MAX_CTX_NAME_LEN) : rawCtxName;
+            const rawCtxPath = input.filePath;
+            const ctxPath = typeof rawCtxPath === 'string' && rawCtxPath.length > MAX_CTX_PATH_LEN
+                ? rawCtxPath.slice(0, MAX_CTX_PATH_LEN) : rawCtxPath;
+            const result = getMonographContext(db, {
+                name: ctxName,
+                filePath: ctxPath,
+            });
+            if (!result || !result.node)
+                return text(`No symbol found: ${ctxName}`);
+            // Format context as structured text for direct LLM consumption
+            const n = result.node;
+            const loc = n.filePath ? (n.startLine != null ? `${n.filePath}:${n.startLine}` : n.filePath) : '';
+            const lines = [
+                `[${n.label ?? '?'}] ${n.name}  ${loc}`,
+                '',
+            ];
+            const formatNodes = (nodes, label) => {
+                if (!Array.isArray(nodes) || nodes.length === 0)
+                    return;
+                lines.push(`${label} (${nodes.length}):`);
+                for (const node of nodes.slice(0, 20)) {
+                    const fp = node.filePath ?? node.file_path ?? '';
+                    const ln = node.startLine ?? node.start_line;
+                    const nodeLoc = fp ? (ln != null ? `${fp}:${ln}` : fp) : '';
+                    lines.push(`  [${node.label ?? '?'}] ${node.name ?? node.id}  ${nodeLoc}`);
+                }
+                if (nodes.length > 20)
+                    lines.push(`  … ${nodes.length - 20} more`);
+                lines.push('');
+            };
+            formatNodes(result.callers, 'Callers');
+            formatNodes(result.callees, 'Callees');
+            formatNodes(result.imports, 'Imports');
+            formatNodes(result.importedBy, 'ImportedBy');
+            if (result.community != null)
+                lines.push(`Community: ${result.community}`);
+            if (result.communityName)
+                lines.push(`Community name: ${result.communityName}`);
+            return text(lines.join('\n').trim());
+        }
+        finally {
+            closeDb(db);
+        }
+    },
+};
+// ── monograph_neighbors ───────────────────────────────────────────────────────
+export const monographNeighborsTool = {
+    name: 'monograph_neighbors',
+    description: 'Show all directly connected nodes for a given symbol — outbound and optionally inbound edges, with relation types.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            name: { type: 'string', description: 'Symbol name to look up' },
+            relationFilter: { type: 'string', description: 'Filter by relation type, e.g. IMPORTS, CALLS' },
+            includeInbound: { type: 'boolean', description: 'Include inbound edges (default: false)' },
+        },
+        required: ['name'],
+    },
+    handler: async (input) => {
+        const { openDb, closeDb, getMonographNeighbors } = await import('@monoes/monograph');
+        const db = openDb(getDbPath());
+        try {
+            const result = getMonographNeighbors(db, {
+                name: input.name,
+                relationFilter: input.relationFilter,
+                includeInbound: input.includeInbound ?? false,
+            });
+            if (!result.node)
+                return text(`No node found with name: ${input.name}`);
+            const nodeFilePath = result.node.filePath ?? '';
+            const nodeStartLine = result.node.startLine ?? result.node.start_line;
+            const nodeLoc = nodeFilePath ? (nodeStartLine != null ? `${nodeFilePath}:${nodeStartLine}` : nodeFilePath) : '';
+            const lines = [
+                `[${result.node.label}] ${result.node.name}  ${nodeLoc}`,
+                `Neighbors: ${result.neighbors.length}`,
+                '',
+                ...result.neighbors.map(n => {
+                    const fp = n.node.filePath ?? n.node.file_path ?? '';
+                    const ln = n.node.startLine ?? n.node.start_line;
+                    const loc = fp ? (ln != null ? `${fp}:${ln}` : fp) : '';
+                    return `  ${n.direction === 'inbound' ? '←' : '→'} [${n.node.label}] ${n.node.name}  (${n.relation})  ${loc}`;
+                }),
+            ];
+            return text(lines.join('\n'));
+        }
+        finally {
+            closeDb(db);
+        }
+    },
+};
+// ── monograph_get_node ────────────────────────────────────────────────────────
+export const monographGetNodeTool = {
+    name: 'monograph_get_node',
+    description: 'Get a specific node by exact ID or name.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: { type: 'string', description: 'Node ID or name to look up' },
+        },
+        required: ['id'],
+    },
+    handler: async (input) => {
+        const { openDb, closeDb, getNode } = await import('@monoes/monograph');
+        const db = openDb(getDbPath());
+        try {
+            let node = getNode(db, input.id);
+            if (!node) {
+                const row = db.prepare('SELECT * FROM nodes WHERE name = ? LIMIT 1').get(input.id);
+                if (row)
+                    node = row;
+            }
+            if (!node)
+                return text(`Node not found: ${input.id}`);
+            return text(JSON.stringify(node, null, 2));
+        }
+        finally {
+            closeDb(db);
+        }
+    },
+};
+// ── monograph_god_nodes ───────────────────────────────────────────────────────
+export const monographGodNodesTool = {
+    name: 'monograph_god_nodes',
+    description: 'Return the top-N most connected real code entities (excludes File/Folder/Community nodes).',
+    inputSchema: {
+        type: 'object',
+        properties: { limit: { type: 'number', description: 'Max nodes to return (default 20)' } },
+    },
+    handler: async (input) => {
+        const dbPath = getDbPath();
+        if (!_isValidDb(dbPath))
+            return text('Monograph index not built yet. Run monograph_build first.');
+        const { openDb, closeDb } = await import('@monoes/monograph');
+        const db = openDb(dbPath);
+        try {
+            // Cap limit: passed directly to the SQL LIMIT clause.
+            const MAX_GOD_NODES_LIMIT = 1_000;
+            const rawGodLimit = input.limit ?? 20;
+            const limit = Number.isFinite(rawGodLimit) && rawGodLimit > 0
+                ? Math.min(Math.floor(rawGodLimit), MAX_GOD_NODES_LIMIT)
+                : 20;
+            const excluded = ['File', 'Folder', 'Community', 'Concept'];
+            const rows = db.prepare(`
+        SELECT n.id, n.label, n.name, n.file_path, n.start_line,
+               COUNT(DISTINCT e1.id) + COUNT(DISTINCT e2.id) AS degree,
+               COUNT(DISTINCT e2.id) AS in_degree,
+               COUNT(DISTINCT e1.id) AS out_degree
+        FROM nodes n
+        LEFT JOIN edges e1 ON e1.source_id = n.id
+        LEFT JOIN edges e2 ON e2.target_id = n.id
+        WHERE n.label NOT IN (${excluded.map(() => '?').join(',')})
+        GROUP BY n.id HAVING degree > 0
+        ORDER BY degree DESC LIMIT ?
+      `).all(...excluded, limit);
+            if (rows.length === 0)
+                return text('No god nodes found. Run monograph_build first.');
+            const lines = rows.map(r => {
+                const loc = r.file_path ? (r.start_line != null ? `${r.file_path}:${r.start_line}` : r.file_path) : '';
+                return `[${r.label}] ${r.name}  degree=${r.degree} (↑${r.out_degree} ↓${r.in_degree})  ${loc}`;
+            });
+            return text(lines.join('\n'));
+        }
+        finally {
+            closeDb(db);
+        }
+    },
+};
+// ── monograph_augment ─────────────────────────────────────────────────────────
+export const monographAugmentTool = {
+    name: 'monograph_augment',
+    description: 'Retrieve relevant code context for a query using graph-RAG. Returns formatted context block for injection into AI prompts.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: { type: 'string', description: 'The search query or task description' },
+            topK: { type: 'number', description: 'Number of results (default: 10)' },
+            format: { type: 'string', enum: ['markdown', 'json'], description: 'Output format (default: markdown)' },
+        },
+        required: ['query'],
+    },
+    handler: async (input) => {
+        const { augmentContext } = await import('@monoes/monograph');
+        const repoPath = getProjectCwd();
+        // Cap query (forwarded to FTS/embedding in augmentContext) and topK
+        // (controls how many context nodes are retrieved).
+        const MAX_AUGMENT_QUERY_LEN = 16 * 1024;
+        const MAX_AUGMENT_TOP_K = 100;
+        const rawAugmentQuery = input.query;
+        const augmentQuery = typeof rawAugmentQuery === 'string' && rawAugmentQuery.length > MAX_AUGMENT_QUERY_LEN
+            ? rawAugmentQuery.slice(0, MAX_AUGMENT_QUERY_LEN) : rawAugmentQuery;
+        const rawTopK = input.topK ?? 10;
+        const topK = Number.isFinite(rawTopK) && rawTopK > 0
+            ? Math.min(Math.floor(rawTopK), MAX_AUGMENT_TOP_K) : 10;
+        const result = await augmentContext({
+            query: augmentQuery,
+            repoPath,
+            topK,
+            format: input.format ?? 'markdown',
+        });
+        return text(result);
+    },
+};
+// ── monograph_cypher ──────────────────────────────────────────────────────────
+export const monographCypherTool = {
+    name: 'monograph_cypher',
+    description: 'Execute a restricted read-only Cypher-style MATCH query against the Monograph knowledge graph. Supports node and relationship patterns. Write operations (CREATE, MERGE, SET, DELETE, REMOVE, DROP) are blocked.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            query: {
+                type: 'string',
+                description: 'Cypher MATCH query. Example: MATCH (a:Function)-[:CALLS]->(b:Function {name: "authenticate"}) RETURN a.name, a.filePath',
+            },
+        },
+        required: ['query'],
+    },
+    handler: async (input) => {
+        const { openDb, closeDb } = await import('@monoes/monograph');
+        const { getMonographCypher } = await import('@monoes/monograph');
+        const db = openDb(getDbPath());
+        try {
+            // Cap query: forwarded to the Cypher query engine; very long strings
+            // waste parse time and can stress the query compiler.
+            const MAX_CYPHER_QUERY_LEN = 16 * 1024;
+            const rawCypherQuery = input.query;
+            const cypherQuery = typeof rawCypherQuery === 'string' && rawCypherQuery.length > MAX_CYPHER_QUERY_LEN
+                ? rawCypherQuery.slice(0, MAX_CYPHER_QUERY_LEN)
+                : rawCypherQuery;
+            const result = getMonographCypher(db, cypherQuery);
+            if (result.error)
+                return text(`Error: ${result.error}`);
+            if (result.rows.length === 0)
+                return text('No results found.');
+            const header = Object.keys(result.rows[0]).join('\t');
+            const lines = result.rows.map(r => Object.values(r).join('\t'));
+            return text([header, ...lines, `\n(${result.rows.length} rows, ${result.queryTime}ms)`].join('\n'));
+        }
+        finally {
+            closeDb(db);
+        }
+    },
+};
+// ── monograph_shortest_path ───────────────────────────────────────────────────
+export const monographShortestPathTool = {
+    name: 'monograph_shortest_path',
+    description: 'Find the shortest path between two nodes in the dependency graph.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            source: { type: 'string', description: 'Source node ID or name' },
+            target: { type: 'string', description: 'Target node ID or name' },
+            maxDepth: { type: 'number', description: 'Max path depth (default 6)' },
+        },
+        required: ['source', 'target'],
+    },
+    handler: async (input) => {
+        const { openDb, closeDb, getShortestPath } = await import('@monoes/monograph');
+        const db = openDb(getDbPath());
+        try {
+            const path = getShortestPath(db, input.source, input.target, input.maxDepth ?? 6);
+            if (!path)
+                return text(`No path found between ${input.source} and ${input.target}`);
+            // Enrich each node ID with file:line for direct LLM navigation
+            const enriched = path.map(nodeId => {
+                const row = db.prepare('SELECT label, name, file_path, start_line FROM nodes WHERE id = ? OR name = ? LIMIT 1').get(nodeId, nodeId);
+                if (!row)
+                    return nodeId;
+                const loc = row.file_path ? (row.start_line != null ? `${row.file_path}:${row.start_line}` : row.file_path) : '';
+                return loc ? `${row.name ?? nodeId}  [${loc}]` : (row.name ?? nodeId);
+            });
+            return text(`Path (${path.length - 1} hops):\n${enriched.join(' → ')}`);
+        }
+        finally {
+            closeDb(db);
+        }
+    },
+};
+//# sourceMappingURL=query-tools.js.map

package/dist/src/mcp-tools/monograph/query-tools.js.map

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

package/dist/src/mcp-tools/monograph/shared.d.ts

@@ -0,0 +1,64 @@
+export declare function _isValidDb(p: string): boolean;
+/**
+ * Resolve the monograph DB path for a given repo root (defaults to project cwd).
+ * Falls back to searching up to the git root when the DB isn't directly under
+ * `<cwd>/.monomind` — e.g. when called from a subdirectory of the repo. Only
+ * the no-arg (project cwd) form is cached; explicit `repoPath` overrides are
+ * cheap one-off lookups (staleness checks with a user-supplied path) so caching
+ * them isn't worth the invalidation complexity.
+ */
+export declare function getDbPath(repoPathOverride?: string): string;
+export declare function text(t: string): {
+    content: {
+        type: 'text';
+        text: string;
+    }[];
+};
+export type PprScoredNode = {
+    id: string;
+    name: string;
+    label: string;
+    filePath: string;
+    startLine: number | null;
+    score: number;
+};
+export declare function applyPprRerank(db: any, seedNodes: PprScoredNode[], damping: number, maxResults: number): Array<PprScoredNode & {
+    boostedByNeighbors: boolean;
+}>;
+/**
+ * Compute how many commits the index is behind HEAD.
+ * Returns { commitsBehind, lastCommit } — or null if the index has never been
+ * built or git is unavailable.
+ */
+export declare function computeCommitsBehind(repoPath: string): Promise<{
+    commitsBehind: number;
+    lastCommit: string;
+} | null>;
+/**
+ * Shared staleness threshold: both monograph_staleness and monograph_suggest (checkStaleness)
+ * trigger a background rebuild only when the index is more than this many commits behind HEAD.
+ * Using a shared constant prevents conflicting rebuild pressure during active dev sessions.
+ * Was 10 → 3 → 1. Even 3 let routine small commits accumulate stale results
+ * silently. At 1 (rebuild triggers at 2+ behind), staleness rarely persists
+ * across sessions.
+ */
+export declare const STALENESS_THRESHOLD = 1;
+/**
+ * Fire-and-forget background rebuild. Uses a module-level guard so concurrent
+ * MCP tool calls (e.g. repeated monograph_suggest checkStaleness) don't pile up builds.
+ * threshold: minimum commitsBehind to trigger (default STALENESS_THRESHOLD + 1).
+ */
+export declare function triggerBackgroundBuildIfNeeded(repoPath: string, commitsBehind: number, threshold?: number): boolean;
+/**
+ * BM25 ranks purely on literal keyword overlap, so a doc/concept node whose
+ * prose happens to mention task-related words (e.g. a report mentioning
+ * "retry" constants) can outrank the actual code symbol the task is really
+ * about, which is conceptually related but lexically different (issue #38).
+ * Prefer code-symbol hits (Function/Class/Method/...) over doc-type hits
+ * (Document/Concept/Section/...) when there are any, falling back to the
+ * full hit list so a genuinely doc-only task still gets results.
+ */
+export declare function preferSymbolHits<T extends {
+    label: string;
+}>(hits: T[], symbolLabels: ReadonlySet<string>): T[];
+//# sourceMappingURL=shared.d.ts.map

package/dist/src/mcp-tools/monograph/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../../src/mcp-tools/monograph/shared.ts"],"names":[],"mappings":"AAWA,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE7C;AACD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,CAmB3D;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM;;cACD,MAAM;;;EAClC;AAID,MAAM,MAAM,aAAa,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AACnI,wBAAgB,cAAc,CAC5B,EAAE,EAAE,GAAG,EACP,SAAS,EAAE,aAAa,EAAE,EAC1B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,KAAK,CAAC,aAAa,GAAG;IAAE,kBAAkB,EAAE,OAAO,CAAA;CAAE,CAAC,CAuExD;AAKD;;;;GAIG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAmC1H;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC;;;;GAIG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,SAA0B,GAAG,OAAO,CAWpI;AAED;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAG/G"}