purecontext-mcp 1.1.7 → 1.2.0

package/dist/server/tools/render-dep-matrix.d.ts

@@ -0,0 +1,38 @@
+/**
+ * render-dep-matrix.ts
+ *
+ * MCP tool: render_dep_matrix
+ *
+ * Render a dependency matrix (coupling heatmap) for the top-N most coupled
+ * files in the repo. Matrix cell [row][col] is 1 when row imports col, 0
+ * otherwise; the diagonal is always "—".
+ *
+ * Two formats:
+ *   'ascii'   — text table (default). Token-efficient, renders in any markdown.
+ *   'mermaid' — `graph TD` showing direct import edges between the top-N files.
+ *               More useful than xychart-beta which cannot represent a matrix.
+ *
+ * File selection: the N files with the highest total coupling
+ * (efferentCoupling + afferentCoupling) are chosen. Use `filePath` to scope
+ * selection to a directory.
+ */
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "render_dep_matrix";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    topN: z.ZodOptional<z.ZodNumber>;
+    filePath: z.ZodOptional<z.ZodString>;
+    format: z.ZodOptional<z.ZodEnum<{
+        ascii: "ascii";
+        mermaid: "mermaid";
+    }>>;
+};
+export declare function handler(args: {
+    repoId: string;
+    topN?: number;
+    filePath?: string;
+    format?: 'ascii' | 'mermaid';
+}): Promise<CallToolResult>;
+//# sourceMappingURL=render-dep-matrix.d.ts.map

package/dist/server/tools/render-dep-matrix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-dep-matrix.d.ts","sourceRoot":"","sources":["../../../src/server/tools/render-dep-matrix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAYxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,IAAI,sBAAsB,CAAC;AAExC,eAAO,MAAM,WAAW,QAO2B,CAAC;AAEpD,eAAO,MAAM,WAAW;;;;;;;;CAuBvB,CAAC;AA6GF,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAC9B,GAAG,OAAO,CAAC,cAAc,CAAC,CAkE1B"}

package/dist/server/tools/render-dep-matrix.js

@@ -0,0 +1,186 @@
+/**
+ * render-dep-matrix.ts
+ *
+ * MCP tool: render_dep_matrix
+ *
+ * Render a dependency matrix (coupling heatmap) for the top-N most coupled
+ * files in the repo. Matrix cell [row][col] is 1 when row imports col, 0
+ * otherwise; the diagonal is always "—".
+ *
+ * Two formats:
+ *   'ascii'   — text table (default). Token-efficient, renders in any markdown.
+ *   'mermaid' — `graph TD` showing direct import edges between the top-N files.
+ *               More useful than xychart-beta which cannot represent a matrix.
+ *
+ * File selection: the N files with the highest total coupling
+ * (efferentCoupling + afferentCoupling) are chosen. Use `filePath` to scope
+ * selection to a directory.
+ */
+import { z } from 'zod';
+import { openDatabase, getRepo } from '../../core/db/schema.js';
+import { getCouplingMap } from '../../core/db/dep-store.js';
+import { sanitizeId, shortLabel, parentDir, renderMermaidModule, } from '../../graph/diagram-renderer.js';
+import { buildMeta } from './_meta.js';
+export const name = 'render_dep_matrix';
+export const description = 'Render a dependency matrix for the top-N most coupled files. ' +
+    'Each cell shows 1 if the row file imports the column file, 0 otherwise; ' +
+    'the diagonal shows "—". ' +
+    'ASCII format (default) is token-efficient and renders in any markdown context. ' +
+    'Mermaid format produces a graph TD showing import edges between the top-N files. ' +
+    'Use topN (default 10) to control how many files appear. ' +
+    'Use filePath to scope selection to a directory.';
+export const inputSchema = {
+    repoId: z.string().describe('Repo ID from index_folder or resolve_repo'),
+    topN: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .optional()
+        .describe('Number of most-coupled files to include (default 10)'),
+    filePath: z
+        .string()
+        .optional()
+        .describe('Scope file selection to files under this directory path (relative to repo root). ' +
+        'When omitted, selects from the whole repo.'),
+    format: z
+        .enum(['ascii', 'mermaid'])
+        .optional()
+        .describe('"ascii" (default) — text table readable in any markdown. ' +
+        '"mermaid" — graph TD diagram of import edges between the selected files.'),
+};
+// ─── Rendering helpers ────────────────────────────────────────────────────────
+/**
+ * Return the last `segments` path components of a file path.
+ * e.g. `src/core/index-manager.ts` → `core/index-manager.ts` (segments=2)
+ */
+function truncatePath(filePath, segments = 2) {
+    const parts = filePath.replace(/\\/g, '/').split('/');
+    return parts.slice(-segments).join('/');
+}
+/**
+ * Render a text dependency matrix.
+ *
+ * Rows = files (labelled with last-2-segment names).
+ * Columns = same files (headers use last-2-segment names, potentially padded).
+ * Cell: '1' if row imports col, '0' otherwise, '—' on diagonal.
+ */
+function renderAsciiMatrix(filePaths, importMap) {
+    if (filePaths.length === 0)
+        return '(no files)';
+    const rowLabels = filePaths.map((fp) => truncatePath(fp));
+    const colHeaders = filePaths.map((fp) => truncatePath(fp));
+    // Measure column widths (at least 1 char for the cell value)
+    const colWidths = colHeaders.map((h) => h.length);
+    const rowLabelWidth = Math.max(...rowLabels.map((l) => l.length));
+    const lines = [];
+    const GAP = 2; // spaces between columns
+    // Build header line
+    const headerParts = [' '.repeat(rowLabelWidth)];
+    for (let c = 0; c < colHeaders.length; c++) {
+        headerParts.push(colHeaders[c].padStart(colWidths[c] + GAP));
+    }
+    lines.push(headerParts.join(''));
+    // Build data rows
+    for (let r = 0; r < filePaths.length; r++) {
+        const rowImports = importMap.get(filePaths[r]) ?? new Set();
+        const parts = [rowLabels[r].padEnd(rowLabelWidth)];
+        for (let c = 0; c < filePaths.length; c++) {
+            let cell;
+            if (r === c) {
+                cell = '—';
+            }
+            else {
+                cell = rowImports.has(filePaths[c]) ? '1' : '0';
+            }
+            parts.push(cell.padStart(colWidths[c] + GAP));
+        }
+        lines.push(parts.join(''));
+    }
+    return lines.join('\n');
+}
+/**
+ * Render a `graph TD` Mermaid diagram showing import edges between the
+ * top-N files. Only edges where both endpoints are in the selected set are
+ * drawn (same semantics as matrix cells with value 1).
+ */
+function renderMermaidMatrix(filePaths, importMap) {
+    const fileSet = new Set(filePaths);
+    const nodes = filePaths.map((fp) => ({
+        id: sanitizeId(fp),
+        label: shortLabel(fp),
+        fullPath: fp,
+        group: parentDir(fp),
+    }));
+    const seenEdges = new Set();
+    const edges = [];
+    for (const fp of filePaths) {
+        for (const dep of importMap.get(fp) ?? new Set()) {
+            if (!fileSet.has(dep))
+                continue;
+            const key = `${fp}→${dep}`;
+            if (!seenEdges.has(key)) {
+                seenEdges.add(key);
+                edges.push({ source: sanitizeId(fp), target: sanitizeId(dep) });
+            }
+        }
+    }
+    return renderMermaidModule(nodes, edges);
+}
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export async function handler(args) {
+    const t0 = Date.now();
+    const { repoId, topN = 10, filePath, format = 'ascii' } = args;
+    const db = openDatabase(repoId);
+    try {
+        const repo = getRepo(db, repoId);
+        if (!repo) {
+            return {
+                content: [
+                    { type: 'text', text: JSON.stringify({ error: `Repo "${repoId}" not found. Run index_folder first.` }) },
+                ],
+                isError: true,
+            };
+        }
+        // Fetch coupling rows for the whole repo (or scoped path).
+        let rows = getCouplingMap(db, repoId, filePath);
+        // When scoping to a directory, filter to files under that path.
+        if (filePath) {
+            const prefix = filePath.endsWith('/') ? filePath : filePath + '/';
+            rows = rows.filter((r) => r.filePath.startsWith(prefix) || r.filePath === filePath);
+        }
+        // Sort by total coupling descending, stable by filePath.
+        rows.sort((a, b) => b.efferentCoupling + b.afferentCoupling - (a.efferentCoupling + a.afferentCoupling) ||
+            a.filePath.localeCompare(b.filePath));
+        // Take top-N.
+        rows = rows.slice(0, topN);
+        const filePaths = rows.map((r) => r.filePath);
+        // Build a set-of-targets per file for O(1) lookup during matrix construction.
+        const importMap = new Map();
+        for (const r of rows) {
+            importMap.set(r.filePath, new Set(r.efferentDeps));
+        }
+        // Render the matrix in the requested format.
+        let matrix;
+        if (format === 'mermaid') {
+            matrix = renderMermaidMatrix(filePaths, importMap);
+        }
+        else {
+            matrix = renderAsciiMatrix(filePaths, importMap);
+        }
+        const output = {
+            matrix,
+            files: filePaths,
+            format,
+            _tokenEstimate: Math.ceil(matrix.length / 4),
+            _meta: buildMeta({ timingMs: Date.now() - t0 }),
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=render-dep-matrix.js.map

package/dist/server/tools/render-dep-matrix.js.map

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

package/dist/server/tools/render-diagram.d.ts

@@ -0,0 +1,47 @@
+/**
+ * render-diagram.ts
+ *
+ * MCP tool: render_diagram
+ *
+ * Generate a Mermaid or DOT diagram from the dependency graph for a file,
+ * directory, or the whole repo. The primary general-purpose visualization tool —
+ * specialized variants (render_call_graph, render_class_hierarchy, etc.) build
+ * on this foundation.
+ *
+ * Diagram types:
+ *   'module'  — file-level import graph, nodes = files, clustered by directory
+ *   'call'    — call graph rooted at rootSymbolId (requires Task 174 data)
+ *   'class'   — class inheritance rooted at rootSymbolId (requires Task 175 data)
+ *   'import'  — alias for 'module' at the symbol level (same DB, different label)
+ */
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "render_diagram";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    type: z.ZodEnum<{
+        class: "class";
+        import: "import";
+        module: "module";
+        call: "call";
+    }>;
+    rootSymbolId: z.ZodOptional<z.ZodString>;
+    filePath: z.ZodOptional<z.ZodString>;
+    maxNodes: z.ZodOptional<z.ZodNumber>;
+    maxDepth: z.ZodOptional<z.ZodNumber>;
+    format: z.ZodOptional<z.ZodEnum<{
+        dot: "dot";
+        mermaid: "mermaid";
+    }>>;
+};
+export declare function handler(args: {
+    repoId: string;
+    type: 'module' | 'call' | 'class' | 'import';
+    rootSymbolId?: string;
+    filePath?: string;
+    maxNodes?: number;
+    maxDepth?: number;
+    format?: 'mermaid' | 'dot';
+}): Promise<CallToolResult>;
+//# sourceMappingURL=render-diagram.d.ts.map

package/dist/server/tools/render-diagram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-diagram.d.ts","sourceRoot":"","sources":["../../../src/server/tools/render-diagram.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAiBxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,eAAO,MAAM,IAAI,mBAAmB,CAAC;AAErC,eAAO,MAAM,WAAW,QAOsD,CAAC;AAE/E,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;CAsCvB,CAAC;AAgBF,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;CAC5B,GAAG,OAAO,CAAC,cAAc,CAAC,CAgG1B"}

package/dist/server/tools/render-diagram.js

@@ -0,0 +1,266 @@
+/**
+ * render-diagram.ts
+ *
+ * MCP tool: render_diagram
+ *
+ * Generate a Mermaid or DOT diagram from the dependency graph for a file,
+ * directory, or the whole repo. The primary general-purpose visualization tool —
+ * specialized variants (render_call_graph, render_class_hierarchy, etc.) build
+ * on this foundation.
+ *
+ * Diagram types:
+ *   'module'  — file-level import graph, nodes = files, clustered by directory
+ *   'call'    — call graph rooted at rootSymbolId (requires Task 174 data)
+ *   'class'   — class inheritance rooted at rootSymbolId (requires Task 175 data)
+ *   'import'  — alias for 'module' at the symbol level (same DB, different label)
+ */
+import { z } from 'zod';
+import { openDatabase, getRepo } from '../../core/db/schema.js';
+import { getAllDepEdges } from '../../core/db/dep-store.js';
+import { buildCallHierarchy, buildClassHierarchy } from '../../graph/graph-traversal.js';
+import { sanitizeId, shortLabel, parentDir, pruneGraph, renderMermaidModule, renderMermaidCallGraph, renderMermaidClassDiagram, renderDot, } from '../../graph/diagram-renderer.js';
+import { buildMeta } from './_meta.js';
+export const name = 'render_diagram';
+export const description = 'Generate a Mermaid or DOT diagram from the indexed dependency graph. ' +
+    'Use type "module" for a file-level import graph of the whole repo or a directory. ' +
+    'Use type "call" with rootSymbolId for a call hierarchy flowchart. ' +
+    'Use type "class" with rootSymbolId for a class inheritance classDiagram. ' +
+    'Use type "import" for the same as "module" (alias). ' +
+    'Mermaid output renders natively in GitHub, VS Code, and Claude. ' +
+    'maxNodes (default 30) and maxDepth (default 3) prevent oversized diagrams.';
+export const inputSchema = {
+    repoId: z.string().describe('Repo ID from index_folder or resolve_repo'),
+    type: z
+        .enum(['module', 'call', 'class', 'import'])
+        .describe('"module"/"import" — file-level import graph; ' +
+        '"call" — call graph (requires rootSymbolId); ' +
+        '"class" — class hierarchy (requires rootSymbolId)'),
+    rootSymbolId: z
+        .string()
+        .optional()
+        .describe('Anchor symbol ID for call/class diagrams. Required for type "call" and "class".'),
+    filePath: z
+        .string()
+        .optional()
+        .describe('Scope the diagram to a directory or file prefix (relative to repo root). ' +
+        'E.g. "src/core/" restricts the module diagram to that directory.'),
+    maxNodes: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .optional()
+        .describe('Maximum number of nodes to include. Least-connected nodes are dropped first. Default 30.'),
+    maxDepth: z
+        .number()
+        .int()
+        .min(1)
+        .max(10)
+        .optional()
+        .describe('Maximum traversal depth for call/class diagrams. Default 3.'),
+    format: z
+        .enum(['mermaid', 'dot'])
+        .optional()
+        .describe('Output format. Default "mermaid".'),
+};
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export async function handler(args) {
+    const t0 = Date.now();
+    const { repoId, type, rootSymbolId, filePath, maxNodes = 30, maxDepth = 3, format = 'mermaid', } = args;
+    const db = openDatabase(repoId);
+    try {
+        const repo = getRepo(db, repoId);
+        if (!repo) {
+            return {
+                content: [
+                    { type: 'text', text: JSON.stringify({ error: `Repo "${repoId}" not found. Run index_folder first.` }) },
+                ],
+                isError: true,
+            };
+        }
+        let nodes;
+        let edges;
+        if (type === 'module' || type === 'import') {
+            ({ nodes, edges } = buildModuleGraph(repoId, db, filePath));
+        }
+        else if (type === 'call') {
+            if (!rootSymbolId) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: 'rootSymbolId is required for type "call".' }) }],
+                    isError: true,
+                };
+            }
+            const result = buildCallHierarchy(rootSymbolId, repoId, db, 'both', maxDepth, maxNodes * 2);
+            if (!result) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: `Symbol "${rootSymbolId}" not found.` }) }],
+                    isError: true,
+                };
+            }
+            ({ nodes, edges } = flattenCallTree(result.root, result.root.symbolId));
+        }
+        else {
+            // type === 'class'
+            if (!rootSymbolId) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: 'rootSymbolId is required for type "class".' }) }],
+                    isError: true,
+                };
+            }
+            const result = buildClassHierarchy(rootSymbolId, repoId, db, 'both', maxDepth, true);
+            if (!result) {
+                return {
+                    content: [{ type: 'text', text: JSON.stringify({ error: `Symbol "${rootSymbolId}" not found.` }) }],
+                    isError: true,
+                };
+            }
+            ({ nodes, edges } = flattenClassTree(result.root));
+        }
+        // Apply maxNodes pruning
+        const { nodes: prunedNodes, edges: prunedEdges, truncated } = pruneGraph(nodes, edges, maxNodes);
+        // Render
+        let diagram;
+        if (format === 'dot') {
+            diagram = renderDot(prunedNodes, prunedEdges);
+        }
+        else if (type === 'call') {
+            const rootNode = prunedNodes.find((n) => n.styleClass === 'root');
+            const rootId = rootNode?.id ?? (prunedNodes[0]?.id ?? '');
+            diagram = renderMermaidCallGraph(prunedNodes, prunedEdges, rootId);
+        }
+        else if (type === 'class') {
+            diagram = renderMermaidClassDiagram(prunedNodes, prunedEdges);
+        }
+        else {
+            diagram = renderMermaidModule(prunedNodes, prunedEdges);
+        }
+        const output = {
+            diagram,
+            format,
+            nodeCount: prunedNodes.length,
+            edgeCount: prunedEdges.length,
+            truncated,
+            _tokenEstimate: Math.ceil(diagram.length / 4),
+            _meta: buildMeta({ timingMs: Date.now() - t0 }),
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+// ─── Module graph builder ─────────────────────────────────────────────────────
+function buildModuleGraph(repoId, db, filePathScope) {
+    const allEdges = getAllDepEdges(db, repoId);
+    // Filter by scope prefix if provided
+    const scopePrefix = filePathScope
+        ? filePathScope.endsWith('/') ? filePathScope : filePathScope + '/'
+        : null;
+    const scopedEdges = scopePrefix
+        ? allEdges.filter((e) => e.sourceFile.startsWith(scopePrefix) && e.targetFile.startsWith(scopePrefix))
+        : allEdges;
+    // Collect unique file paths
+    const fileSet = new Set();
+    for (const e of scopedEdges) {
+        fileSet.add(e.sourceFile);
+        fileSet.add(e.targetFile);
+    }
+    const nodes = Array.from(fileSet).map((fp) => ({
+        id: sanitizeId(fp),
+        label: shortLabel(fp),
+        fullPath: fp,
+        group: parentDir(fp),
+    }));
+    // Deduplicate edges (same source→target pair may appear multiple times)
+    const seenEdges = new Set();
+    const edges = [];
+    for (const e of scopedEdges) {
+        const key = `${e.sourceFile}→${e.targetFile}`;
+        if (!seenEdges.has(key)) {
+            seenEdges.add(key);
+            edges.push({
+                source: sanitizeId(e.sourceFile),
+                target: sanitizeId(e.targetFile),
+            });
+        }
+    }
+    return { nodes, edges };
+}
+// ─── Call tree flattener ──────────────────────────────────────────────────────
+function flattenCallTree(root, rootSymbolId) {
+    const nodeMap = new Map();
+    const edges = [];
+    const visited = new Set();
+    function walk(node, parentId) {
+        const nodeId = sanitizeId(node.symbolId);
+        const isRoot = node.symbolId === rootSymbolId;
+        if (!nodeMap.has(nodeId)) {
+            nodeMap.set(nodeId, {
+                id: nodeId,
+                label: `${node.name}\n${shortLabel(node.filePath)}`,
+                fullPath: node.filePath,
+                group: parentDir(node.filePath),
+                styleClass: isRoot ? 'root' : undefined,
+            });
+        }
+        if (parentId !== null && !visited.has(`${parentId}→${nodeId}`)) {
+            visited.add(`${parentId}→${nodeId}`);
+            edges.push({
+                source: parentId,
+                target: nodeId,
+                dashed: node.cyclic,
+            });
+        }
+        if (!node.cyclic) {
+            for (const child of node.children) {
+                walk(child, nodeId);
+            }
+        }
+    }
+    walk(root, null);
+    return { nodes: Array.from(nodeMap.values()), edges };
+}
+// ─── Class hierarchy flattener ────────────────────────────────────────────────
+function flattenClassTree(root) {
+    const nodeMap = new Map();
+    const edges = [];
+    const visited = new Set();
+    function nodeKey(node) {
+        return node.symbolId ?? `ext_${sanitizeId(node.name)}`;
+    }
+    function walk(node, parentNode) {
+        const key = sanitizeId(nodeKey(node));
+        if (!nodeMap.has(key)) {
+            nodeMap.set(key, {
+                id: key,
+                label: node.name,
+                fullPath: node.filePath ?? '',
+                group: node.filePath ? parentDir(node.filePath) : 'external',
+                styleClass: node.filePath === null ? 'external' : undefined,
+            });
+        }
+        if (parentNode !== null) {
+            const parentKey = sanitizeId(nodeKey(parentNode));
+            const edgeKey = `${key}→${parentKey}`;
+            if (!visited.has(edgeKey)) {
+                visited.add(edgeKey);
+                // parent is an ancestor (depth < 0) or interface → dashed for implements
+                const isInterface = parentNode.isInterface;
+                edges.push({
+                    source: key,
+                    target: parentKey,
+                    dashed: isInterface,
+                    label: isInterface ? 'implements' : 'extends',
+                });
+            }
+        }
+        for (const child of node.children) {
+            walk(child, node);
+        }
+    }
+    walk(root, null);
+    return { nodes: Array.from(nodeMap.values()), edges };
+}
+//# sourceMappingURL=render-diagram.js.map

package/dist/server/tools/render-diagram.js.map

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

package/dist/server/tools/render-import-graph.d.ts

@@ -0,0 +1,41 @@
+/**
+ * render-import-graph.ts
+ *
+ * MCP tool: render_import_graph
+ *
+ * Render a file-level import graph for a directory as a Mermaid or DOT diagram.
+ *
+ * Node categories:
+ *   - In-scope nodes   — files whose path starts with `filePath` (no special style)
+ *   - Boundary nodes   — files OUTSIDE `filePath` that are imported by in-scope files
+ *                        (shown with a grey fill so the import boundary is visible)
+ *   - External nodes   — npm package specifiers (only when includeExternal: true;
+ *                        these are not stored in dep_edges so they are a no-op at
+ *                        the moment — the parameter is accepted for API stability)
+ *
+ * All dep_edges are internal file-to-file edges (external npm imports are dropped
+ * at graph-build time in graph-builder.ts). Boundary nodes are detected by
+ * comparing `targetFile` against the `filePath` scope prefix.
+ */
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "render_import_graph";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    filePath: z.ZodString;
+    includeExternal: z.ZodOptional<z.ZodBoolean>;
+    maxNodes: z.ZodOptional<z.ZodNumber>;
+    format: z.ZodOptional<z.ZodEnum<{
+        dot: "dot";
+        mermaid: "mermaid";
+    }>>;
+};
+export declare function handler(args: {
+    repoId: string;
+    filePath: string;
+    includeExternal?: boolean;
+    maxNodes?: number;
+    format?: 'mermaid' | 'dot';
+}): Promise<CallToolResult>;
+//# sourceMappingURL=render-import-graph.d.ts.map

package/dist/server/tools/render-import-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-import-graph.d.ts","sourceRoot":"","sources":["../../../src/server/tools/render-import-graph.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAcxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,IAAI,wBAAwB,CAAC;AAE1C,eAAO,MAAM,WAAW,QAM2C,CAAC;AAEpE,eAAO,MAAM,WAAW;;;;;;;;;CA4BvB,CAAC;AAeF,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,GAAG,KAAK,CAAC;CAC5B,GAAG,OAAO,CAAC,cAAc,CAAC,CAyH1B"}