@grafema/mcp 0.2.1-beta → 0.2.6-beta

package/dist/handlers/analysis-handlers.js

@@ -0,0 +1,73 @@
+/**
+ * MCP Analysis Handlers
+ */
+import { ensureAnalyzed } from '../analysis.js';
+import { getAnalysisStatus, getOrCreateBackend, isAnalysisRunning } from '../state.js';
+import { textResult, errorResult, } from '../utils.js';
+// === ANALYSIS HANDLERS ===
+export async function handleAnalyzeProject(args) {
+    const { service, force } = args;
+    // Early check: return error for force=true if analysis is already running
+    // This provides immediate feedback instead of waiting or causing corruption
+    if (force && isAnalysisRunning()) {
+        return errorResult('Cannot force re-analysis: analysis is already in progress. ' +
+            'Use get_analysis_status to check current status, or wait for completion.');
+    }
+    // Note: setIsAnalyzed(false) is now handled inside ensureAnalyzed() within the lock
+    // to prevent race conditions where multiple calls could both clear the database
+    try {
+        await ensureAnalyzed(service || null, force || false);
+        const status = getAnalysisStatus();
+        return textResult(`Analysis complete!\n` +
+            `- Services discovered: ${status.servicesDiscovered}\n` +
+            `- Services analyzed: ${status.servicesAnalyzed}\n` +
+            `- Total time: ${status.timings.total || 'N/A'}s`);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return errorResult(message);
+    }
+}
+export async function handleGetAnalysisStatus() {
+    const status = getAnalysisStatus();
+    return textResult(`Analysis Status:\n` +
+        `- Running: ${status.running}\n` +
+        `- Phase: ${status.phase || 'N/A'}\n` +
+        `- Message: ${status.message || 'N/A'}\n` +
+        `- Services discovered: ${status.servicesDiscovered}\n` +
+        `- Services analyzed: ${status.servicesAnalyzed}\n` +
+        (status.error ? `- Error: ${status.error}\n` : ''));
+}
+export async function handleGetStats() {
+    const db = await getOrCreateBackend();
+    const nodeCount = await db.nodeCount();
+    const edgeCount = await db.edgeCount();
+    const nodesByType = await db.countNodesByType();
+    const edgesByType = await db.countEdgesByType();
+    return textResult(`Graph Statistics:\n\n` +
+        `Total nodes: ${nodeCount.toLocaleString()}\n` +
+        `Total edges: ${edgeCount.toLocaleString()}\n\n` +
+        `Nodes by type:\n${JSON.stringify(nodesByType, null, 2)}\n\n` +
+        `Edges by type:\n${JSON.stringify(edgesByType, null, 2)}`);
+}
+export async function handleGetSchema(args) {
+    const db = await getOrCreateBackend();
+    const { type = 'all' } = args;
+    const nodesByType = await db.countNodesByType();
+    const edgesByType = await db.countEdgesByType();
+    let output = '';
+    if (type === 'nodes' || type === 'all') {
+        output += `Node Types (${Object.keys(nodesByType).length}):\n`;
+        for (const [t, count] of Object.entries(nodesByType)) {
+            output += `  - ${t}: ${count}\n`;
+        }
+    }
+    if (type === 'edges' || type === 'all') {
+        output += `\nEdge Types (${Object.keys(edgesByType).length}):\n`;
+        for (const [t, count] of Object.entries(edgesByType)) {
+            output += `  - ${t}: ${count}\n`;
+        }
+    }
+    return textResult(output);
+}
+//# sourceMappingURL=analysis-handlers.js.map

package/dist/handlers/analysis-handlers.js.map

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

package/dist/handlers/context-handlers.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MCP Context Handlers
+ */
+import type { ToolResult, GetFunctionDetailsArgs, GetContextArgs, GetFileOverviewArgs } from '../types.js';
+/**
+ * Get comprehensive function details including calls made and callers.
+ *
+ * Graph structure:
+ * ```
+ * FUNCTION -[HAS_SCOPE]-> SCOPE -[CONTAINS]-> CALL/METHOD_CALL
+ *                         SCOPE -[CONTAINS]-> SCOPE (nested blocks)
+ * CALL -[CALLS]-> FUNCTION (target)
+ * ```
+ *
+ * This is the core tool for understanding function behavior.
+ * Use transitive=true to follow call chains (A -> B -> C).
+ */
+export declare function handleGetFunctionDetails(args: GetFunctionDetailsArgs): Promise<ToolResult>;
+export declare function handleGetContext(args: GetContextArgs): Promise<ToolResult>;
+export declare function handleGetFileOverview(args: GetFileOverviewArgs): Promise<ToolResult>;
+//# sourceMappingURL=context-handlers.d.ts.map

package/dist/handlers/context-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/context-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,OAAO,KAAK,EACV,UAAU,EACV,sBAAsB,EACtB,cAAc,EACd,mBAAmB,EAEpB,MAAM,aAAa,CAAC;AAIrB;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,sBAAsB,GAC3B,OAAO,CAAC,UAAU,CAAC,CA6ErB;AA+CD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,GACnB,OAAO,CAAC,UAAU,CAAC,CAkIrB;AAID,wBAAsB,qBAAqB,CACzC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,UAAU,CAAC,CA2GrB"}

package/dist/handlers/context-handlers.js

@@ -0,0 +1,330 @@
+/**
+ * MCP Context Handlers
+ */
+import { ensureAnalyzed } from '../analysis.js';
+import { getProjectPath } from '../state.js';
+import { findCallsInFunction, findContainingFunction, FileOverview, buildNodeContext, getNodeDisplayName, formatEdgeMetadata, STRUCTURAL_EDGE_TYPES } from '@grafema/core';
+import { existsSync, readFileSync, realpathSync } from 'fs';
+import { isAbsolute, join, relative } from 'path';
+import { serializeBigInt, textResult, errorResult, } from '../utils.js';
+// === GET FUNCTION DETAILS (REG-254) ===
+/**
+ * Get comprehensive function details including calls made and callers.
+ *
+ * Graph structure:
+ * ```
+ * FUNCTION -[HAS_SCOPE]-> SCOPE -[CONTAINS]-> CALL/METHOD_CALL
+ *                         SCOPE -[CONTAINS]-> SCOPE (nested blocks)
+ * CALL -[CALLS]-> FUNCTION (target)
+ * ```
+ *
+ * This is the core tool for understanding function behavior.
+ * Use transitive=true to follow call chains (A -> B -> C).
+ */
+export async function handleGetFunctionDetails(args) {
+    const db = await ensureAnalyzed();
+    const { name, file, transitive = false } = args;
+    // Step 1: Find the function
+    const candidates = [];
+    for await (const node of db.queryNodes({ type: 'FUNCTION' })) {
+        if (node.name !== name)
+            continue;
+        if (file && !node.file?.includes(file))
+            continue;
+        candidates.push(node);
+    }
+    if (candidates.length === 0) {
+        return errorResult(`Function "${name}" not found.` +
+            (file ? ` (searched in files matching "${file}")` : ''));
+    }
+    if (candidates.length > 1 && !file) {
+        const locations = candidates.map(f => `${f.file}:${f.line}`).join(', ');
+        return errorResult(`Multiple functions named "${name}" found: ${locations}. ` +
+            `Use the "file" parameter to disambiguate.`);
+    }
+    const targetFunction = candidates[0];
+    // Step 2: Find calls using shared utility
+    const calls = await findCallsInFunction(db, targetFunction.id, {
+        transitive,
+        transitiveDepth: 5,
+    });
+    // Step 3: Find callers
+    const calledBy = [];
+    const incomingCalls = await db.getIncomingEdges(targetFunction.id, ['CALLS']);
+    const seenCallers = new Set();
+    for (const edge of incomingCalls) {
+        const caller = await findContainingFunction(db, edge.src);
+        if (caller && !seenCallers.has(caller.id)) {
+            seenCallers.add(caller.id);
+            calledBy.push(caller);
+        }
+    }
+    // Step 4: Build result
+    const result = {
+        id: targetFunction.id,
+        name: targetFunction.name,
+        file: targetFunction.file,
+        line: targetFunction.line,
+        async: targetFunction.async,
+        calls,
+        calledBy,
+    };
+    // Format output
+    const summary = [
+        `Function: ${result.name}`,
+        `File: ${result.file || 'unknown'}:${result.line || '?'}`,
+        `Async: ${result.async || false}`,
+        `Transitive: ${transitive}`,
+        '',
+        `Calls (${calls.length}):`,
+        ...formatCallsForDisplay(calls),
+        '',
+        `Called by (${calledBy.length}):`,
+        ...calledBy.map(c => `  - ${c.name} (${c.file}:${c.line})`),
+    ].join('\n');
+    return textResult(summary + '\n\n' +
+        JSON.stringify(serializeBigInt(result), null, 2));
+}
+/**
+ * Format calls for display, grouped by depth if transitive
+ */
+function formatCallsForDisplay(calls) {
+    const directCalls = calls.filter(c => (c.depth || 0) === 0);
+    const transitiveCalls = calls.filter(c => (c.depth || 0) > 0);
+    const lines = [];
+    // Direct calls
+    for (const c of directCalls) {
+        const target = c.resolved
+            ? ` -> ${c.target?.name} (${c.target?.file}:${c.target?.line})`
+            : ' (unresolved)';
+        const prefix = c.type === 'METHOD_CALL' ? `${c.object}.` : '';
+        lines.push(`  - ${prefix}${c.name}()${target}`);
+    }
+    // Transitive calls (grouped by depth)
+    if (transitiveCalls.length > 0) {
+        lines.push('');
+        lines.push('  Transitive calls:');
+        const byDepth = new Map();
+        for (const c of transitiveCalls) {
+            const depth = c.depth || 1;
+            if (!byDepth.has(depth))
+                byDepth.set(depth, []);
+            byDepth.get(depth).push(c);
+        }
+        for (const [depth, depthCalls] of Array.from(byDepth.entries()).sort((a, b) => a[0] - b[0])) {
+            for (const c of depthCalls) {
+                const indent = '  '.repeat(depth + 1);
+                const prefix = c.type === 'METHOD_CALL' ? `${c.object}.` : '';
+                const target = c.resolved ? ` -> ${c.target?.name}` : '';
+                lines.push(`${indent}[depth=${depth}] ${prefix}${c.name}()${target}`);
+            }
+        }
+    }
+    return lines;
+}
+// === NODE CONTEXT (REG-406) ===
+export async function handleGetContext(args) {
+    const db = await ensureAnalyzed();
+    const { semanticId, contextLines: ctxLines = 3, edgeType } = args;
+    // 1. Look up node
+    const node = await db.getNode(semanticId);
+    if (!node) {
+        return errorResult(`Node not found: "${semanticId}"\n` +
+            `Use find_nodes or query_graph to find the correct semantic ID.`);
+    }
+    const edgeTypeFilter = edgeType
+        ? new Set(edgeType.split(',').map(t => t.trim().toUpperCase()))
+        : null;
+    // 2. Build context using shared logic
+    const projectPath = getProjectPath();
+    const ctx = await buildNodeContext(db, node, {
+        contextLines: ctxLines,
+        edgeTypeFilter,
+        readFileContent: (filePath) => {
+            const absPath = isAbsolute(filePath) ? filePath : join(projectPath, filePath);
+            if (!existsSync(absPath))
+                return null;
+            try {
+                return readFileSync(absPath, 'utf-8');
+            }
+            catch {
+                return null;
+            }
+        },
+    });
+    // 3. Format text output
+    const relFile = node.file ? (isAbsolute(node.file) ? relative(projectPath, node.file) : node.file) : undefined;
+    const lines = [];
+    lines.push(`[${node.type}] ${getNodeDisplayName(node)}`);
+    lines.push(`  ID: ${node.id}`);
+    if (relFile) {
+        lines.push(`  Location: ${relFile}${node.line ? `:${node.line}` : ''}`);
+    }
+    // Source
+    if (ctx.source) {
+        lines.push('');
+        lines.push(`  Source (lines ${ctx.source.startLine}-${ctx.source.endLine}):`);
+        const maxLineNum = ctx.source.endLine;
+        const lineNumWidth = String(maxLineNum).length;
+        for (let i = 0; i < ctx.source.lines.length; i++) {
+            const lineNum = ctx.source.startLine + i;
+            const paddedNum = String(lineNum).padStart(lineNumWidth, ' ');
+            const prefix = lineNum === node.line ? '>' : ' ';
+            const displayLine = ctx.source.lines[i].length > 120
+                ? ctx.source.lines[i].slice(0, 117) + '...'
+                : ctx.source.lines[i];
+            lines.push(`    ${prefix}${paddedNum} | ${displayLine}`);
+        }
+    }
+    const formatEdgeSection = (groups, dir) => {
+        for (const group of groups) {
+            const isStructural = STRUCTURAL_EDGE_TYPES.has(group.edgeType);
+            lines.push(`    ${group.edgeType} (${group.edges.length}):`);
+            for (const { edge, node: connNode } of group.edges) {
+                if (!connNode) {
+                    const danglingId = dir === '->' ? edge.dst : edge.src;
+                    lines.push(`      ${dir} [dangling] ${danglingId}`);
+                    continue;
+                }
+                const nFile = connNode.file ? (isAbsolute(connNode.file) ? relative(projectPath, connNode.file) : connNode.file) : '';
+                const nLoc = nFile ? (connNode.line ? `${nFile}:${connNode.line}` : nFile) : '';
+                const locStr = nLoc ? `  (${nLoc})` : '';
+                const metaStr = formatEdgeMetadata(edge);
+                lines.push(`      ${dir} [${connNode.type}] ${getNodeDisplayName(connNode)}${locStr}${metaStr}`);
+                // Code context for non-structural edges
+                if (!isStructural && connNode.file && connNode.line && ctxLines > 0) {
+                    const absoluteConnFile = !isAbsolute(connNode.file) ? join(projectPath, connNode.file) : connNode.file;
+                    if (existsSync(absoluteConnFile)) {
+                        try {
+                            const content = readFileSync(absoluteConnFile, 'utf-8');
+                            const allFileLines = content.split('\n');
+                            const nLine = connNode.line;
+                            const sLine = Math.max(1, nLine - Math.min(ctxLines, 2));
+                            const eLine = Math.min(allFileLines.length, nLine + Math.min(ctxLines, 2));
+                            const w = String(eLine).length;
+                            for (let i = sLine; i <= eLine; i++) {
+                                const p = i === nLine ? '>' : ' ';
+                                const ln = String(i).padStart(w, ' ');
+                                const displayLn = allFileLines[i - 1].length > 120
+                                    ? allFileLines[i - 1].slice(0, 117) + '...'
+                                    : allFileLines[i - 1];
+                                lines.push(`           ${p}${ln} | ${displayLn}`);
+                            }
+                        }
+                        catch { /* ignore */ }
+                    }
+                }
+            }
+        }
+    };
+    if (ctx.outgoing.length > 0) {
+        lines.push('');
+        lines.push('  Outgoing edges:');
+        formatEdgeSection(ctx.outgoing, '->');
+    }
+    if (ctx.incoming.length > 0) {
+        lines.push('');
+        lines.push('  Incoming edges:');
+        formatEdgeSection(ctx.incoming, '<-');
+    }
+    if (ctx.outgoing.length === 0 && ctx.incoming.length === 0) {
+        lines.push('');
+        lines.push('  No edges found.');
+    }
+    // Build JSON result alongside text
+    const jsonResult = {
+        node: { id: node.id, type: node.type, name: node.name, file: relFile, line: node.line },
+        source: ctx.source ? {
+            startLine: ctx.source.startLine,
+            endLine: ctx.source.endLine,
+            lines: ctx.source.lines,
+        } : null,
+        outgoing: Object.fromEntries(ctx.outgoing.map(g => [g.edgeType, g.edges])),
+        incoming: Object.fromEntries(ctx.incoming.map(g => [g.edgeType, g.edges])),
+    };
+    return textResult(lines.join('\n') + '\n\n' + JSON.stringify(serializeBigInt(jsonResult), null, 2));
+}
+// === FILE OVERVIEW (REG-412) ===
+export async function handleGetFileOverview(args) {
+    const db = await ensureAnalyzed();
+    const projectPath = getProjectPath();
+    const { file, include_edges: includeEdges = true } = args;
+    let filePath = file;
+    if (!filePath.startsWith('/')) {
+        filePath = join(projectPath, filePath);
+    }
+    if (!existsSync(filePath)) {
+        return errorResult(`File not found: ${file}\n` +
+            `Resolved to: ${filePath}\n` +
+            `Project root: ${projectPath}`);
+    }
+    const absolutePath = realpathSync(filePath);
+    const relativePath = relative(projectPath, absolutePath);
+    try {
+        const overview = new FileOverview(db);
+        const result = await overview.getOverview(absolutePath, {
+            includeEdges,
+        });
+        result.file = relativePath;
+        if (result.status === 'NOT_ANALYZED') {
+            return textResult(`File not analyzed: ${relativePath}\n` +
+                `Run analyze_project to build the graph.`);
+        }
+        const lines = [];
+        lines.push(`Module: ${result.file}`);
+        if (result.imports.length > 0) {
+            const sources = result.imports.map(i => i.source);
+            lines.push(`Imports: ${sources.join(', ')}`);
+        }
+        if (result.exports.length > 0) {
+            const names = result.exports.map(e => e.isDefault ? `${e.name} (default)` : e.name);
+            lines.push(`Exports: ${names.join(', ')}`);
+        }
+        if (result.classes.length > 0) {
+            lines.push('');
+            lines.push('Classes:');
+            for (const cls of result.classes) {
+                const ext = cls.extends ? ` extends ${cls.extends}` : '';
+                lines.push(`  ${cls.name}${ext} (line ${cls.line ?? '?'})`);
+                for (const m of cls.methods) {
+                    const calls = m.calls.length > 0
+                        ? `  -> ${m.calls.join(', ')}`
+                        : '';
+                    const params = m.params
+                        ? `(${m.params.join(', ')})`
+                        : '()';
+                    lines.push(`    ${m.name}${params}${calls}`);
+                }
+            }
+        }
+        if (result.functions.length > 0) {
+            lines.push('');
+            lines.push('Functions:');
+            for (const fn of result.functions) {
+                const calls = fn.calls.length > 0
+                    ? `  -> ${fn.calls.join(', ')}`
+                    : '';
+                const params = fn.params
+                    ? `(${fn.params.join(', ')})`
+                    : '()';
+                const asyncStr = fn.async ? 'async ' : '';
+                lines.push(`  ${asyncStr}${fn.name}${params}${calls}  (line ${fn.line ?? '?'})`);
+            }
+        }
+        if (result.variables.length > 0) {
+            lines.push('');
+            lines.push('Variables:');
+            for (const v of result.variables) {
+                const assign = v.assignedFrom ? ` = ${v.assignedFrom}` : '';
+                lines.push(`  ${v.kind} ${v.name}${assign}  (line ${v.line ?? '?'})`);
+            }
+        }
+        return textResult(lines.join('\n') + '\n\n' +
+            JSON.stringify(serializeBigInt(result), null, 2));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return errorResult(`Failed to get file overview: ${message}`);
+    }
+}
+//# sourceMappingURL=context-handlers.js.map

package/dist/handlers/context-handlers.js.map

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

package/dist/handlers/coverage-handlers.d.ts

@@ -0,0 +1,6 @@
+/**
+ * MCP Coverage Handlers
+ */
+import type { ToolResult, GetCoverageArgs } from '../types.js';
+export declare function handleGetCoverage(args: GetCoverageArgs): Promise<ToolResult>;
+//# sourceMappingURL=coverage-handlers.d.ts.map

package/dist/handlers/coverage-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/coverage-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EAChB,MAAM,aAAa,CAAC;AAIrB,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,CAsClF"}

package/dist/handlers/coverage-handlers.js

@@ -0,0 +1,42 @@
+/**
+ * MCP Coverage Handlers
+ */
+import { getOrCreateBackend, getProjectPath } from '../state.js';
+import { CoverageAnalyzer } from '@grafema/core';
+import { textResult, errorResult, } from '../utils.js';
+// === COVERAGE ===
+export async function handleGetCoverage(args) {
+    const db = await getOrCreateBackend();
+    const projectPath = getProjectPath();
+    const { path: targetPath = projectPath } = args;
+    try {
+        const analyzer = new CoverageAnalyzer(db, targetPath);
+        const result = await analyzer.analyze();
+        // Format output for AI agents
+        let output = `Analysis Coverage for ${targetPath}\n`;
+        output += `==============================\n\n`;
+        output += `File breakdown:\n`;
+        output += `  Total files:     ${result.total}\n`;
+        output += `  Analyzed:        ${result.analyzed.count} (${result.percentages.analyzed}%) - in graph\n`;
+        output += `  Unsupported:     ${result.unsupported.count} (${result.percentages.unsupported}%) - no indexer available\n`;
+        output += `  Unreachable:     ${result.unreachable.count} (${result.percentages.unreachable}%) - not imported from entrypoints\n`;
+        if (result.unsupported.count > 0) {
+            output += `\nUnsupported files by extension:\n`;
+            for (const [ext, files] of Object.entries(result.unsupported.byExtension)) {
+                output += `  ${ext}: ${files.length} files\n`;
+            }
+        }
+        if (result.unreachable.count > 0) {
+            output += `\nUnreachable source files:\n`;
+            for (const [ext, files] of Object.entries(result.unreachable.byExtension)) {
+                output += `  ${ext}: ${files.length} files\n`;
+            }
+        }
+        return textResult(output);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return errorResult(`Failed to calculate coverage: ${message}`);
+    }
+}
+//# sourceMappingURL=coverage-handlers.js.map

package/dist/handlers/coverage-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coverage-handlers.js","sourceRoot":"","sources":["../../src/handlers/coverage-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EACL,UAAU,EACV,WAAW,GACZ,MAAM,aAAa,CAAC;AAMrB,mBAAmB;AAEnB,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAqB;IAC3D,MAAM,EAAE,GAAG,MAAM,kBAAkB,EAAE,CAAC;IACtC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,WAAW,EAAE,GAAG,IAAI,CAAC;IAEhD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;QAExC,8BAA8B;QAC9B,IAAI,MAAM,GAAG,yBAAyB,UAAU,IAAI,CAAC;QACrD,MAAM,IAAI,oCAAoC,CAAC;QAE/C,MAAM,IAAI,mBAAmB,CAAC;QAC9B,MAAM,IAAI,sBAAsB,MAAM,CAAC,KAAK,IAAI,CAAC;QACjD,MAAM,IAAI,sBAAsB,MAAM,CAAC,QAAQ,CAAC,KAAK,KAAK,MAAM,CAAC,WAAW,CAAC,QAAQ,iBAAiB,CAAC;QACvG,MAAM,IAAI,sBAAsB,MAAM,CAAC,WAAW,CAAC,KAAK,KAAK,MAAM,CAAC,WAAW,CAAC,WAAW,6BAA6B,CAAC;QACzH,MAAM,IAAI,sBAAsB,MAAM,CAAC,WAAW,CAAC,KAAK,KAAK,MAAM,CAAC,WAAW,CAAC,WAAW,sCAAsC,CAAC;QAElI,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,qCAAqC,CAAC;YAChD,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC1E,MAAM,IAAI,KAAK,GAAG,KAAK,KAAK,CAAC,MAAM,UAAU,CAAC;YAChD,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,WAAW,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,+BAA+B,CAAC;YAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC1E,MAAM,IAAI,KAAK,GAAG,KAAK,KAAK,CAAC,MAAM,UAAU,CAAC;YAChD,CAAC;QACH,CAAC;QAED,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,WAAW,CAAC,iCAAiC,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;AACH,CAAC"}

package/dist/handlers/dataflow-handlers.d.ts

@@ -0,0 +1,8 @@
+/**
+ * MCP Dataflow Handlers
+ */
+import type { ToolResult, TraceAliasArgs, TraceDataFlowArgs, CheckInvariantArgs } from '../types.js';
+export declare function handleTraceAlias(args: TraceAliasArgs): Promise<ToolResult>;
+export declare function handleTraceDataFlow(args: TraceDataFlowArgs): Promise<ToolResult>;
+export declare function handleCheckInvariant(args: CheckInvariantArgs): Promise<ToolResult>;
+//# sourceMappingURL=dataflow-handlers.d.ts.map

package/dist/handlers/dataflow-handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataflow-handlers.d.ts","sourceRoot":"","sources":["../../src/handlers/dataflow-handlers.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,KAAK,EACV,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAEnB,MAAM,aAAa,CAAC;AAIrB,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CA2DhF;AAED,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CA+DtF;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,CA6CxF"}