@monoes/monograph 1.1.0 → 1.2.1

package/dist/src/mcp-tools/context.js.map

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

package/dist/src/mcp-tools/cypher.d.ts

@@ -0,0 +1,23 @@
+import type Database from 'better-sqlite3';
+import { formatCypherResult } from '../query/cypher-parser.js';
+import type { CypherResult } from '../query/cypher-parser.js';
+export type { CypherResult };
+export { formatCypherResult };
+/**
+ * Execute a restricted read-only Cypher-style query against the Monograph graph.
+ *
+ * @param db - Open better-sqlite3 database handle
+ * @param query - Cypher MATCH query string
+ * @returns CypherResult with rows, queryTime, and optional error
+ */
+export declare function getMonographCypher(db: Database.Database, query: string): CypherResult;
+/**
+ * Execute a Cypher-style query and return structured text for LLM consumption.
+ * Rows with filePath + startLine fields are rendered as "file:line" navigation hints.
+ *
+ * @param db - Open better-sqlite3 database handle
+ * @param query - Cypher MATCH query string
+ * @returns Formatted string suitable for direct injection into LLM context
+ */
+export declare function getMonographCypherText(db: Database.Database, query: string): string;
+//# sourceMappingURL=cypher.d.ts.map

package/dist/src/mcp-tools/cypher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cypher.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/cypher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAsB,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,YAAY,EAAE,YAAY,EAAE,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAErF;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEnF"}

package/dist/src/mcp-tools/cypher.js

@@ -0,0 +1,24 @@
+import { executeCypherQuery, formatCypherResult } from '../query/cypher-parser.js';
+export { formatCypherResult };
+/**
+ * Execute a restricted read-only Cypher-style query against the Monograph graph.
+ *
+ * @param db - Open better-sqlite3 database handle
+ * @param query - Cypher MATCH query string
+ * @returns CypherResult with rows, queryTime, and optional error
+ */
+export function getMonographCypher(db, query) {
+    return executeCypherQuery(db, query);
+}
+/**
+ * Execute a Cypher-style query and return structured text for LLM consumption.
+ * Rows with filePath + startLine fields are rendered as "file:line" navigation hints.
+ *
+ * @param db - Open better-sqlite3 database handle
+ * @param query - Cypher MATCH query string
+ * @returns Formatted string suitable for direct injection into LLM context
+ */
+export function getMonographCypherText(db, query) {
+    return formatCypherResult(executeCypherQuery(db, query));
+}
+//# sourceMappingURL=cypher.js.map

package/dist/src/mcp-tools/cypher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cypher.js","sourceRoot":"","sources":["../../../src/mcp-tools/cypher.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAInF,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAqB,EAAE,KAAa;IACrE,OAAO,kBAAkB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CAAC,EAAqB,EAAE,KAAa;IACzE,OAAO,kBAAkB,CAAC,kBAAkB,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/src/mcp-tools/detect-changes.d.ts

@@ -0,0 +1,19 @@
+import type Database from 'better-sqlite3';
+export interface MonographDetectChangesResult {
+    changedFiles: string[];
+    affectedSymbols: Array<{
+        name: string;
+        filePath: string;
+        label: string;
+    }>;
+    affectedProcesses: Array<{
+        id: string;
+        name: string;
+    }>;
+    error?: string;
+}
+export declare function detectMonographChanges(db: Database.Database, input: {
+    baseBranch?: string;
+    includeTests?: boolean;
+}, repoPath: string): MonographDetectChangesResult;
+//# sourceMappingURL=detect-changes.d.ts.map

package/dist/src/mcp-tools/detect-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-changes.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/detect-changes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAK3C,MAAM,WAAW,4BAA4B;IAC3C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1E,iBAAiB,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAAE,EACtD,QAAQ,EAAE,MAAM,GACf,4BAA4B,CA6F9B"}

package/dist/src/mcp-tools/detect-changes.js

@@ -0,0 +1,92 @@
+import { spawnSync } from 'child_process';
+// ── Implementation ─────────────────────────────────────────────────────────────
+const MAX_FILES = 200; // cap on changed-file count to prevent unbounded IN clauses
+const MAX_STDOUT = 1_048_576; // 1 MiB stdout cap for git output
+export function detectMonographChanges(db, input, repoPath) {
+    const rawBranch = input.baseBranch ?? 'main';
+    // Reject branch names that could be shell-injected or path-traversed
+    if (!/^[a-zA-Z0-9][a-zA-Z0-9._\-/]*$/.test(rawBranch)) {
+        return { changedFiles: [], affectedSymbols: [], affectedProcesses: [], error: `Invalid branch name: ${rawBranch}` };
+    }
+    const baseBranch = rawBranch;
+    const includeTests = input.includeTests ?? true;
+    let changedFiles;
+    try {
+        // Use spawnSync with argument array to eliminate shell injection entirely
+        const result = spawnSync('git', ['diff', '--name-only', `${baseBranch}...HEAD`], {
+            cwd: repoPath,
+            encoding: 'utf-8',
+            maxBuffer: MAX_STDOUT,
+        });
+        if (result.error)
+            throw result.error;
+        if (result.status !== 0)
+            throw new Error(result.stderr ?? `git exited ${result.status}`);
+        const output = (result.stdout ?? '').slice(0, MAX_STDOUT).trim();
+        changedFiles = output
+            .split('\n')
+            .map(f => f.trim())
+            .filter(f => f.length > 0)
+            .slice(0, MAX_FILES); // cap to prevent unbounded IN clauses
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { changedFiles: [], affectedSymbols: [], affectedProcesses: [], error: message };
+    }
+    // Filter out test files if requested
+    if (!includeTests) {
+        changedFiles = changedFiles.filter(f => !(/\.(test|spec)\./.test(f)));
+    }
+    if (changedFiles.length === 0) {
+        return { changedFiles: [], affectedSymbols: [], affectedProcesses: [] };
+    }
+    // Query DB for symbols in changed files (batch if needed)
+    let affectedSymbols = [];
+    let affectedSymbolIds = [];
+    try {
+        // Process in batches of 50 to keep SQLite IN clause size bounded
+        const BATCH = 50;
+        const allRows = [];
+        for (let i = 0; i < changedFiles.length; i += BATCH) {
+            const batch = changedFiles.slice(i, i + BATCH);
+            const placeholders = batch.map(() => '?').join(',');
+            const rows = db
+                .prepare(`SELECT id, name, file_path, label FROM nodes WHERE file_path IN (${placeholders})`)
+                .all(...batch);
+            allRows.push(...rows);
+        }
+        affectedSymbols = allRows.map(r => ({ name: r.name, filePath: r.file_path, label: r.label }));
+        affectedSymbolIds = allRows.map(r => r.id);
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { changedFiles, affectedSymbols: [], affectedProcesses: [], error: message };
+    }
+    // Find processes that contain any of the affected symbols as steps
+    // STEP_IN_PROCESS: process → step_symbol
+    let affectedProcesses = [];
+    if (affectedSymbolIds.length > 0) {
+        try {
+            // Also batch symbol IDs to keep IN clause bounded
+            const BATCH = 50;
+            const processSet = new Map();
+            for (let i = 0; i < affectedSymbolIds.length; i += BATCH) {
+                const batch = affectedSymbolIds.slice(i, i + BATCH);
+                const placeholders = batch.map(() => '?').join(',');
+                const processRows = db
+                    .prepare(`SELECT DISTINCT n.id, n.name
+             FROM nodes n JOIN edges e ON n.id = e.source_id
+             WHERE e.relation = 'STEP_IN_PROCESS' AND e.target_id IN (${placeholders})`)
+                    .all(...batch);
+                for (const row of processRows)
+                    processSet.set(row.id, row.name);
+            }
+            affectedProcesses = Array.from(processSet.entries()).map(([id, name]) => ({ id, name }));
+        }
+        catch {
+            // Non-fatal: return what we have
+        }
+    }
+    return { changedFiles, affectedSymbols, affectedProcesses };
+}
+//# sourceMappingURL=detect-changes.js.map

package/dist/src/mcp-tools/detect-changes.js.map

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

package/dist/src/mcp-tools/embed.d.ts

@@ -0,0 +1,25 @@
+/**
+ * monograph_embed MCP tool
+ *
+ * Embeds all symbol nodes in the Monograph knowledge graph using
+ * Snowflake/snowflake-arctic-embed-xs (384 dimensions).
+ *
+ * Requires @huggingface/transformers to be installed.
+ * Returns { embedded, skipped, model } on success or an error message.
+ */
+import type Database from 'better-sqlite3';
+export interface EmbedToolInput {
+    codeOnly?: boolean;
+    force?: boolean;
+}
+export interface EmbedToolResult {
+    embedded: number;
+    skipped: number;
+    model: string;
+}
+/**
+ * Run the embedding pipeline on the open database.
+ * Exported so the CLI handler can call it after opening the DB.
+ */
+export declare function runEmbed(db: Database.Database, options?: EmbedToolInput): Promise<EmbedToolResult>;
+//# sourceMappingURL=embed.d.ts.map

package/dist/src/mcp-tools/embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/embed.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAG3C,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAID;;;GAGG;AACH,wBAAsB,QAAQ,CAC5B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,eAAe,CAAC,CAsB1B"}

package/dist/src/mcp-tools/embed.js

@@ -0,0 +1,33 @@
+/**
+ * monograph_embed MCP tool
+ *
+ * Embeds all symbol nodes in the Monograph knowledge graph using
+ * Snowflake/snowflake-arctic-embed-xs (384 dimensions).
+ *
+ * Requires @huggingface/transformers to be installed.
+ * Returns { embedded, skipped, model } on success or an error message.
+ */
+const MODEL = 'Snowflake/snowflake-arctic-embed-xs';
+/**
+ * Run the embedding pipeline on the open database.
+ * Exported so the CLI handler can call it after opening the DB.
+ */
+export async function runEmbed(db, options = {}) {
+    const { force = false, codeOnly = false } = options;
+    let getEmbedder;
+    let embedAll;
+    try {
+        const embedderMod = await import('../search/embedder.js');
+        const batchMod = await import('../search/embed-batch.js');
+        getEmbedder = embedderMod.getEmbedder;
+        embedAll = batchMod.embedAll;
+    }
+    catch {
+        throw new Error('@huggingface/transformers is required for embedding. ' +
+            'Install it with: npm install @huggingface/transformers');
+    }
+    const embedder = await getEmbedder();
+    const result = await embedAll(db, embedder, force, codeOnly);
+    return { ...result, model: MODEL };
+}
+//# sourceMappingURL=embed.js.map

package/dist/src/mcp-tools/embed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.js","sourceRoot":"","sources":["../../../src/mcp-tools/embed.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,MAAM,KAAK,GAAG,qCAAqC,CAAC;AAEpD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,EAAqB,EACrB,UAA0B,EAAE;IAE5B,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAEpD,IAAI,WAAmC,CAAC;IACxC,IAAI,QAAkH,CAAC;IAEvH,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,uBAAuB,CAAC,CAAC;QAC1D,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,0BAA0B,CAAC,CAAC;QAC1D,WAAW,GAAG,WAAW,CAAC,WAAW,CAAC;QACtC,QAAQ,GAAG,QAAQ,CAAC,QAA2B,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,uDAAuD;YACrD,wDAAwD,CAC3D,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,WAAW,EAAE,CAAC;IACrC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,EAAE,EAAE,QAA0C,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAE/F,OAAO,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACrC,CAAC"}

package/dist/src/mcp-tools/explain.d.ts

@@ -0,0 +1,9 @@
+import type Database from 'better-sqlite3';
+import type { MonographNode } from '../types.js';
+export interface ExplainResult {
+    node: MonographNode | null;
+    explanation: string | null;
+    connectionCount: number;
+}
+export declare function explainNode(db: Database.Database, name: string): ExplainResult;
+//# sourceMappingURL=explain.d.ts.map

package/dist/src/mcp-tools/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/explain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAkBjD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,aAAa,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAuC9E"}

package/dist/src/mcp-tools/explain.js

@@ -0,0 +1,44 @@
+function rowToNode(row) {
+    return {
+        id: row['id'],
+        label: row['label'],
+        name: row['name'],
+        normLabel: row['norm_label'] ?? '',
+        filePath: row['file_path'],
+        startLine: row['start_line'],
+        endLine: row['end_line'],
+        communityId: row['community_id'],
+        isExported: row['is_exported'] === 1,
+        language: row['language'],
+        properties: row['properties'] ? JSON.parse(row['properties']) : undefined,
+    };
+}
+export function explainNode(db, name) {
+    const nodeRow = db.prepare('SELECT * FROM nodes WHERE name = ? LIMIT 1').get(name);
+    if (!nodeRow)
+        return { node: null, explanation: null, connectionCount: 0 };
+    const node = rowToNode(nodeRow);
+    // Get outbound connections
+    const outRows = db.prepare(`SELECT n.name, e.relation FROM nodes n JOIN edges e ON n.id = e.target_id WHERE e.source_id = ? LIMIT 10`).all(node.id);
+    // Get inbound connections
+    const inRows = db.prepare(`SELECT n.name, e.relation FROM nodes n JOIN edges e ON n.id = e.source_id WHERE e.target_id = ? LIMIT 10`).all(node.id);
+    const connectionCount = outRows.length + inRows.length;
+    const fileRef = node.filePath
+        ? (node.startLine != null ? `${node.filePath}:${node.startLine}` : node.filePath)
+        : null;
+    const fileLine = fileRef ? ` defined in \`${fileRef}\`` : '';
+    let explanation = `**${node.name}** is a ${node.label}${fileLine}.`;
+    if (outRows.length > 0) {
+        const outList = outRows.map(r => `\`${r.name}\` (${r.relation})`).join(', ');
+        explanation += ` It connects to: ${outList}.`;
+    }
+    if (inRows.length > 0) {
+        const inList = inRows.map(r => `\`${r.name}\``).slice(0, 5).join(', ');
+        explanation += ` Referenced by: ${inList}.`;
+    }
+    if (node.communityId != null) {
+        explanation += ` Part of community ${node.communityId}.`;
+    }
+    return { node, explanation, connectionCount };
+}
+//# sourceMappingURL=explain.js.map

package/dist/src/mcp-tools/explain.js.map

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

package/dist/src/mcp-tools/graph-query.d.ts

@@ -0,0 +1,18 @@
+import type Database from 'better-sqlite3';
+import type { MonographNode } from '../types.js';
+export interface GraphQueryInput {
+    query: string;
+    mode?: 'bfs' | 'dfs';
+    /** Direction of edge traversal. 'both' includes incoming edges (callers) and outgoing (callees). Default: 'out' */
+    direction?: 'out' | 'in' | 'both';
+    tokenBudget?: number;
+    depth?: number;
+}
+export interface GraphQueryResult {
+    nodes: MonographNode[];
+    mode: 'bfs' | 'dfs';
+    truncated: boolean;
+    tokenEstimate: number;
+}
+export declare function queryGraph(db: Database.Database, input: GraphQueryInput): GraphQueryResult;
+//# sourceMappingURL=graph-query.d.ts.map

package/dist/src/mcp-tools/graph-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-query.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/graph-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAkBjD,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACrB,mHAAmH;IACnH,SAAS,CAAC,EAAE,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,IAAI,EAAE,KAAK,GAAG,KAAK,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;CACvB;AAMD,wBAAgB,UAAU,CACxB,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,eAAe,GACrB,gBAAgB,CAqFlB"}

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

@@ -0,0 +1,107 @@
+function rowToNode(row) {
+    return {
+        id: row['id'],
+        label: row['label'],
+        name: row['name'],
+        normLabel: row['norm_label'] ?? '',
+        filePath: row['file_path'],
+        startLine: row['start_line'],
+        endLine: row['end_line'],
+        communityId: row['community_id'],
+        isExported: row['is_exported'] === 1,
+        language: row['language'],
+        properties: row['properties'] ? JSON.parse(row['properties']) : undefined,
+    };
+}
+function estimateTokens(nodes) {
+    return nodes.reduce((acc, n) => acc + n.name.length + (n.filePath?.length ?? 0) + 20, 0);
+}
+export function queryGraph(db, input) {
+    const mode = input.mode ?? 'bfs';
+    const direction = input.direction ?? 'out';
+    const tokenBudget = input.tokenBudget ?? 2000;
+    const maxDepth = input.depth ?? 3;
+    // Find seed nodes matching the query
+    const seedRows = db.prepare(`SELECT * FROM nodes WHERE name LIKE ? OR label LIKE ? LIMIT 20`).all(`%${input.query}%`, `%${input.query}%`);
+    const seeds = seedRows.map(rowToNode);
+    const visited = new Map();
+    const result = [];
+    let tokenEstimate = 0;
+    let truncated = false;
+    for (const seed of seeds) {
+        visited.set(seed.id, seed);
+        result.push(seed);
+        tokenEstimate += estimateTokens([seed]);
+        if (tokenEstimate > tokenBudget) {
+            truncated = true;
+            break;
+        }
+    }
+    if (!truncated) {
+        // BFS or DFS expansion
+        const frontier = seeds.map(s => ({ id: s.id, depth: 0 }));
+        // Prepare edge traversal statements for each direction.
+        // 'out' follows outgoing edges (what this node calls/imports/uses).
+        // 'in' follows incoming edges (what calls/imports/uses this node).
+        // 'both' follows both directions — needed for full context (callers + callees).
+        const outEdgeStmt = db.prepare(`SELECT n.* FROM nodes n JOIN edges e ON n.id = e.target_id WHERE e.source_id = ? LIMIT 20`);
+        const inEdgeStmt = db.prepare(`SELECT n.* FROM nodes n JOIN edges e ON n.id = e.source_id WHERE e.target_id = ? LIMIT 20`);
+        const getNeighbors = (id) => {
+            if (direction === 'out')
+                return outEdgeStmt.all(id);
+            if (direction === 'in')
+                return inEdgeStmt.all(id);
+            // 'both': union of outgoing and incoming, deduplicated by id
+            const outRows = outEdgeStmt.all(id);
+            const inRows = inEdgeStmt.all(id);
+            const seen = new Set(outRows.map(r => r['id']));
+            return [...outRows, ...inRows.filter(r => !seen.has(r['id']))];
+        };
+        if (mode === 'bfs') {
+            while (frontier.length > 0 && !truncated) {
+                const { id, depth } = frontier.shift();
+                if (depth >= maxDepth)
+                    continue;
+                const neighbors = getNeighbors(id);
+                for (const row of neighbors) {
+                    const node = rowToNode(row);
+                    if (visited.has(node.id))
+                        continue;
+                    visited.set(node.id, node);
+                    result.push(node);
+                    tokenEstimate += estimateTokens([node]);
+                    if (tokenEstimate > tokenBudget) {
+                        truncated = true;
+                        break;
+                    }
+                    frontier.push({ id: node.id, depth: depth + 1 });
+                }
+            }
+        }
+        else {
+            // DFS: use stack
+            const stack = [...frontier].reverse();
+            while (stack.length > 0 && !truncated) {
+                const { id, depth } = stack.pop();
+                if (depth >= maxDepth)
+                    continue;
+                const neighbors = getNeighbors(id);
+                for (let i = neighbors.length - 1; i >= 0; i--) {
+                    const node = rowToNode(neighbors[i]);
+                    if (visited.has(node.id))
+                        continue;
+                    visited.set(node.id, node);
+                    result.push(node);
+                    tokenEstimate += estimateTokens([node]);
+                    if (tokenEstimate > tokenBudget) {
+                        truncated = true;
+                        break;
+                    }
+                    stack.push({ id: node.id, depth: depth + 1 });
+                }
+            }
+        }
+    }
+    return { nodes: result, mode, truncated, tokenEstimate };
+}
+//# sourceMappingURL=graph-query.js.map

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

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

package/dist/src/mcp-tools/group-list.d.ts

@@ -0,0 +1,26 @@
+/**
+ * MCP Tool backing for monograph_group_list
+ *
+ * Returns metadata for each repo in a group: index timestamp and node count.
+ */
+export interface GroupRepoInfo {
+    name: string;
+    path: string;
+    indexedAt: string | null;
+    nodeCount: number;
+    error?: string;
+}
+export interface GroupListResult {
+    groups: GroupInfo[];
+}
+export interface GroupInfo {
+    name: string;
+    repos: GroupRepoInfo[];
+}
+/**
+ * Get list information for all repos in a group.
+ *
+ * @param configPath - Path to group.yaml (defaults to ./group.yaml)
+ */
+export declare function getGroupList(configPath?: string): Promise<GroupListResult>;
+//# sourceMappingURL=group-list.d.ts.map

package/dist/src/mcp-tools/group-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-list.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/group-list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,SAAS,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAiCD;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAuBhF"}

package/dist/src/mcp-tools/group-list.js

@@ -0,0 +1,62 @@
+/**
+ * MCP Tool backing for monograph_group_list
+ *
+ * Returns metadata for each repo in a group: index timestamp and node count.
+ */
+import { join } from 'path';
+import { existsSync } from 'fs';
+import Database from 'better-sqlite3';
+import { parseGroupConfig } from '../groups/group-config.js';
+function getRepoDbPath(repoPath) {
+    return join(repoPath, '.monomind', 'monograph.db');
+}
+function readRepoStats(repoPath) {
+    const dbPath = getRepoDbPath(repoPath);
+    if (!existsSync(dbPath)) {
+        return { indexedAt: null, nodeCount: 0, error: 'index not found' };
+    }
+    let db = null;
+    try {
+        db = new Database(dbPath, { readonly: true });
+        const metaRow = db
+            .prepare(`SELECT value FROM index_meta WHERE key = 'indexed_at'`)
+            .get();
+        const countRow = db.prepare(`SELECT COUNT(*) as cnt FROM nodes`).get();
+        return { indexedAt: metaRow?.value ?? null, nodeCount: countRow.cnt };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return { indexedAt: null, nodeCount: 0, error: message };
+    }
+    finally {
+        db?.close();
+    }
+}
+/**
+ * Get list information for all repos in a group.
+ *
+ * @param configPath - Path to group.yaml (defaults to ./group.yaml)
+ */
+export async function getGroupList(configPath) {
+    const resolvedPath = configPath ?? join(process.cwd(), 'group.yaml');
+    const config = parseGroupConfig(resolvedPath);
+    const repos = config.repos.map((repo) => {
+        const { indexedAt, nodeCount, error } = readRepoStats(repo.path);
+        return {
+            name: repo.name,
+            path: repo.path,
+            indexedAt,
+            nodeCount,
+            ...(error ? { error } : {}),
+        };
+    });
+    return {
+        groups: [
+            {
+                name: config.name,
+                repos,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=group-list.js.map

package/dist/src/mcp-tools/group-list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-list.js","sourceRoot":"","sources":["../../../src/mcp-tools/group-list.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAmB7D,SAAS,aAAa,CAAC,QAAgB;IACrC,OAAO,IAAI,CAAC,QAAQ,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,aAAa,CACpB,QAAgB;IAEhB,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACxB,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IACrE,CAAC;IAED,IAAI,EAAE,GAA6B,IAAI,CAAC;IACxC,IAAI,CAAC;QACH,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAE9C,MAAM,OAAO,GAAG,EAAE;aACf,OAAO,CAAC,uDAAuD,CAAC;aAChE,GAAG,EAAmC,CAAC;QAE1C,MAAM,QAAQ,GAAG,EAAE,CAAC,OAAO,CAAC,mCAAmC,CAAC,CAAC,GAAG,EAAqB,CAAC;QAE1F,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,IAAI,IAAI,EAAE,SAAS,EAAE,QAAQ,CAAC,GAAG,EAAE,CAAC;IACxE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC3D,CAAC;YAAS,CAAC;QACT,EAAE,EAAE,KAAK,EAAE,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAmB;IACpD,MAAM,YAAY,GAAG,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IAE9C,MAAM,KAAK,GAAoB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACvD,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjE,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS;YACT,SAAS;YACT,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5B,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE;YACN;gBACE,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,KAAK;aACN;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/src/mcp-tools/group-query.d.ts

@@ -0,0 +1,15 @@
+/**
+ * MCP Tool backing for monograph_group_query
+ *
+ * Parses a group.yaml then runs a merged BM25 cross-repo search.
+ */
+import { type GroupResult } from '../groups/group-search.js';
+/**
+ * Run a group-wide query.
+ *
+ * @param groupConfigPath - Path to group.yaml (defaults to ./group.yaml)
+ * @param query           - Search query string
+ * @param limit           - Max results (default 20)
+ */
+export declare function runGroupQuery(groupConfigPath: string | undefined, query: string, limit?: number): Promise<GroupResult[]>;
+//# sourceMappingURL=group-query.d.ts.map

package/dist/src/mcp-tools/group-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-query.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/group-query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAc,KAAK,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAEzE;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,eAAe,EAAE,MAAM,GAAG,SAAS,EACnC,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,EAAE,CAAC,CAIxB"}

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

@@ -0,0 +1,21 @@
+/**
+ * MCP Tool backing for monograph_group_query
+ *
+ * Parses a group.yaml then runs a merged BM25 cross-repo search.
+ */
+import { join } from 'path';
+import { parseGroupConfig } from '../groups/group-config.js';
+import { groupQuery } from '../groups/group-search.js';
+/**
+ * Run a group-wide query.
+ *
+ * @param groupConfigPath - Path to group.yaml (defaults to ./group.yaml)
+ * @param query           - Search query string
+ * @param limit           - Max results (default 20)
+ */
+export async function runGroupQuery(groupConfigPath, query, limit) {
+    const configPath = groupConfigPath ?? join(process.cwd(), 'group.yaml');
+    const config = parseGroupConfig(configPath);
+    return groupQuery(config, query, { limit: limit ?? 20 });
+}
+//# sourceMappingURL=group-query.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"group-query.js","sourceRoot":"","sources":["../../../src/mcp-tools/group-query.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAoB,MAAM,2BAA2B,CAAC;AAEzE;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,eAAmC,EACnC,KAAa,EACb,KAAc;IAEd,MAAM,UAAU,GAAG,eAAe,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,YAAY,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC5C,OAAO,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,EAAE,CAAC,CAAC;AAC3D,CAAC"}

package/dist/src/mcp-tools/group-sync.d.ts

@@ -0,0 +1,17 @@
+/**
+ * MCP Tool backing for monograph_group_sync
+ *
+ * Rebuilds the Contract Registry for a group: scans each repo for Route nodes,
+ * finds cross-repo HTTP contracts, and persists the registry to disk.
+ */
+import { type GroupSyncResult } from '../groups/group-sync.js';
+export type { GroupSyncResult };
+/**
+ * Run a group contract registry sync.
+ *
+ * @param configPath - Path to group.yaml (defaults to ./group.yaml in cwd)
+ * @returns Summary of the sync operation
+ * @throws {Error} If the config file is not found
+ */
+export declare function runGroupSync(configPath?: string): Promise<GroupSyncResult>;
+//# sourceMappingURL=group-sync.d.ts.map

package/dist/src/mcp-tools/group-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"group-sync.d.ts","sourceRoot":"","sources":["../../../src/mcp-tools/group-sync.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1E,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAWhF"}