purecontext-mcp 1.1.7 → 1.2.0

package/dist/server/tools/get-architecture-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-architecture-snapshot.d.ts","sourceRoot":"","sources":["../../../src/server/tools/get-architecture-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,IAAI,8BAA8B,CAAC;AAEhD,eAAO,MAAM,WAAW,QAOqB,CAAC;AAE9C,eAAO,MAAM,WAAW;;;;;;;;;;;CAiBvB,CAAC;AAsJF,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,cAAc,CAAC,CAwM1B"}

package/dist/server/tools/get-architecture-snapshot.js

@@ -0,0 +1,292 @@
+/**
+ * get-architecture-snapshot.ts
+ *
+ * MCP tool: get_architecture_snapshot
+ *
+ * Freeze the current architecture state (dep graph topology + quality metrics)
+ * into a named snapshot, and diff two snapshots to show what changed structurally
+ * between commits or dates.
+ *
+ * Actions:
+ *   'create' — compute current metrics, store as a snapshot row
+ *   'list'   — return all snapshots for the repo, newest first
+ *   'diff'   — compare two snapshot records and return deltas
+ *   'delete' — remove a snapshot by ID
+ *
+ * Storage: `snapshots` table in SQLite — stores aggregated metrics as a JSON
+ * blob plus the file list (for filesAdded/filesRemoved diffing).
+ * No full graph copies are stored.
+ */
+import { z } from 'zod';
+import { randomBytes } from 'crypto';
+import { openDatabase, getRepo } from '../../core/db/schema.js';
+import { getCouplingMap } from '../../core/db/dep-store.js';
+import { findImportCycles } from '../../graph/graph-traversal.js';
+import { buildMeta } from './_meta.js';
+export const name = 'get_architecture_snapshot';
+export const description = 'Freeze the current architecture state into a named snapshot, then diff two snapshots ' +
+    'to measure structural change over time. ' +
+    'action "create": compute fileCount, symbolCount, edgeCount, cycleCount, avgCoupling, ' +
+    'avgComplexity and store them with an optional label. ' +
+    'action "list": return all snapshots for the repo, newest first. ' +
+    'action "diff": compare two snapshots and return deltas (cycleCountDelta < 0 means fewer cycles — good). ' +
+    'action "delete": remove a snapshot by ID.';
+export const inputSchema = {
+    repoId: z.string().describe('Repo ID from index_folder or resolve_repo'),
+    action: z
+        .enum(['create', 'list', 'diff', 'delete'])
+        .describe('"create" | "list" | "diff" | "delete"'),
+    snapshotId: z
+        .string()
+        .optional()
+        .describe('Snapshot ID — required for diff (snapshotId = base) and delete'),
+    compareId: z
+        .string()
+        .optional()
+        .describe('The second snapshot ID to compare against — required for diff'),
+    label: z
+        .string()
+        .optional()
+        .describe('Human-readable label for the snapshot (e.g. "before-auth-refactor")'),
+};
+function ensureSnapshotsTable(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS snapshots (
+      snapshot_id  TEXT    NOT NULL,
+      repo_id      TEXT    NOT NULL,
+      label        TEXT    NOT NULL DEFAULT '',
+      created_at   INTEGER NOT NULL,
+      metrics      TEXT    NOT NULL,
+      PRIMARY KEY (snapshot_id, repo_id),
+      FOREIGN KEY (repo_id) REFERENCES repos(id) ON DELETE CASCADE
+    )
+  `);
+    try {
+        db.exec('CREATE INDEX IF NOT EXISTS idx_snapshots_repo ON snapshots(repo_id, created_at)');
+    }
+    catch {
+        // already exists
+    }
+}
+function rowToRecord(row) {
+    const m = JSON.parse(row.metrics);
+    return {
+        snapshotId: row.snapshot_id,
+        label: row.label,
+        createdAt: new Date(row.created_at).toISOString(),
+        fileCount: m.fileCount,
+        symbolCount: m.symbolCount,
+        edgeCount: m.edgeCount,
+        cycleCount: m.cycleCount,
+        avgCoupling: m.avgCoupling,
+        avgComplexity: m.avgComplexity,
+    };
+}
+// ─── Metrics computation ──────────────────────────────────────────────────────
+function computeMetrics(db, repoId) {
+    // File count
+    const fileRow = db
+        .prepare('SELECT COUNT(*) AS n FROM files WHERE repo_id = ?')
+        .get(repoId);
+    const fileCount = fileRow?.n ?? 0;
+    // Symbol count
+    const symRow = db
+        .prepare('SELECT COUNT(*) AS n FROM symbols WHERE repo_id = ?')
+        .get(repoId);
+    const symbolCount = symRow?.n ?? 0;
+    // Edge count
+    const edgeRow = db
+        .prepare('SELECT COUNT(*) AS n FROM dep_edges WHERE repo_id = ?')
+        .get(repoId);
+    const edgeCount = edgeRow?.n ?? 0;
+    // File paths list
+    const filePaths = db
+        .prepare('SELECT path FROM files WHERE repo_id = ? ORDER BY path')
+        .all(repoId)
+        .map((r) => r.path);
+    // Cycle count — use DFS-based findImportCycles, cap at 500
+    const cyclesResult = findImportCycles(repoId, db, undefined, 500);
+    const cycleCount = cyclesResult.cycles.length;
+    // Average coupling (efferent + afferent per file / 2 averaged across files)
+    const couplingRows = getCouplingMap(db, repoId);
+    let avgCoupling = 0;
+    if (couplingRows.length > 0) {
+        const totalCoupling = couplingRows.reduce((sum, r) => sum + r.efferentCoupling + r.afferentCoupling, 0);
+        avgCoupling = Math.round((totalCoupling / couplingRows.length) * 100) / 100;
+    }
+    // Average cyclomatic complexity from indexed symbols (skip NULLs)
+    const complexityRow = db
+        .prepare('SELECT AVG(cyclomatic_complexity) AS avg FROM symbols WHERE repo_id = ? AND cyclomatic_complexity IS NOT NULL')
+        .get(repoId);
+    const avgComplexity = complexityRow?.avg != null
+        ? Math.round(complexityRow.avg * 100) / 100
+        : 0;
+    return { fileCount, symbolCount, edgeCount, cycleCount, avgCoupling, avgComplexity, files: filePaths };
+}
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export async function handler(args) {
+    const t0 = Date.now();
+    const { repoId, action, snapshotId, compareId, label = '' } = 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,
+            };
+        }
+        // Ensure the snapshots table exists (safe with IF NOT EXISTS)
+        ensureSnapshotsTable(db);
+        if (action === 'create') {
+            const metrics = computeMetrics(db, repoId);
+            const snapId = randomBytes(6).toString('hex'); // 12-char hex
+            const now = Date.now();
+            db.prepare(`
+        INSERT INTO snapshots (snapshot_id, repo_id, label, created_at, metrics)
+        VALUES (?, ?, ?, ?, ?)
+      `).run(snapId, repoId, label, now, JSON.stringify(metrics));
+            const record = {
+                snapshotId: snapId,
+                label,
+                createdAt: new Date(now).toISOString(),
+                fileCount: metrics.fileCount,
+                symbolCount: metrics.symbolCount,
+                edgeCount: metrics.edgeCount,
+                cycleCount: metrics.cycleCount,
+                avgCoupling: metrics.avgCoupling,
+                avgComplexity: metrics.avgComplexity,
+            };
+            const output = {
+                action: 'create',
+                snapshot: record,
+                _meta: buildMeta({ timingMs: Date.now() - t0 }),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
+        }
+        if (action === 'list') {
+            const rows = db
+                .prepare('SELECT * FROM snapshots WHERE repo_id = ? ORDER BY created_at DESC')
+                .all(repoId);
+            const output = {
+                action: 'list',
+                snapshots: rows.map(rowToRecord),
+                _meta: buildMeta({ timingMs: Date.now() - t0 }),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
+        }
+        if (action === 'diff') {
+            if (!snapshotId || !compareId) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({
+                                error: 'action "diff" requires both snapshotId (base) and compareId (compare).',
+                            }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const baseRow = db
+                .prepare('SELECT * FROM snapshots WHERE snapshot_id = ? AND repo_id = ?')
+                .get(snapshotId, repoId);
+            const compareRow = db
+                .prepare('SELECT * FROM snapshots WHERE snapshot_id = ? AND repo_id = ?')
+                .get(compareId, repoId);
+            if (!baseRow) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ error: `Snapshot "${snapshotId}" not found.` }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            if (!compareRow) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ error: `Snapshot "${compareId}" not found.` }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const baseMetrics = JSON.parse(baseRow.metrics);
+            const compareMetrics = JSON.parse(compareRow.metrics);
+            const baseFiles = new Set(baseMetrics.files);
+            const compareFiles = new Set(compareMetrics.files);
+            const filesAdded = compareMetrics.files.filter((f) => !baseFiles.has(f));
+            const filesRemoved = baseMetrics.files.filter((f) => !compareFiles.has(f));
+            const diff = {
+                filesAdded,
+                filesRemoved,
+                symbolsAdded: Math.max(0, compareMetrics.symbolCount - baseMetrics.symbolCount),
+                symbolsRemoved: Math.max(0, baseMetrics.symbolCount - compareMetrics.symbolCount),
+                edgesAdded: Math.max(0, compareMetrics.edgeCount - baseMetrics.edgeCount),
+                edgesRemoved: Math.max(0, baseMetrics.edgeCount - compareMetrics.edgeCount),
+                cycleCountDelta: compareMetrics.cycleCount - baseMetrics.cycleCount,
+                avgCouplingDelta: Math.round((compareMetrics.avgCoupling - baseMetrics.avgCoupling) * 100) / 100,
+                avgComplexityDelta: Math.round((compareMetrics.avgComplexity - baseMetrics.avgComplexity) * 100) / 100,
+            };
+            const output = {
+                action: 'diff',
+                snapshot: rowToRecord(baseRow),
+                diff,
+                _meta: buildMeta({ timingMs: Date.now() - t0 }),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
+        }
+        if (action === 'delete') {
+            if (!snapshotId) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ error: 'action "delete" requires snapshotId.' }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const result = db
+                .prepare('DELETE FROM snapshots WHERE snapshot_id = ? AND repo_id = ?')
+                .run(snapshotId, repoId);
+            if (result.changes === 0) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: JSON.stringify({ error: `Snapshot "${snapshotId}" not found.` }),
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const output = {
+                action: 'delete',
+                _meta: buildMeta({ timingMs: Date.now() - t0 }),
+            };
+            return { content: [{ type: 'text', text: JSON.stringify(output, null, 2) }] };
+        }
+        // Should never reach here (Zod enum validation prevents it)
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: `Unknown action: ${action}` }) }],
+            isError: true,
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=get-architecture-snapshot.js.map

package/dist/server/tools/get-architecture-snapshot.js.map

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

package/dist/server/tools/get-call-hierarchy.d.ts

@@ -0,0 +1,43 @@
+/**
+ * get-call-hierarchy.ts
+ *
+ * MCP tool: get_call_hierarchy
+ *
+ * Return the callers and callees of a function, N levels deep, as a tree
+ * structure. Unlike get_blast_radius (file-level, reverse-only) and
+ * find_references (flat call sites), this tool returns a hierarchical view
+ * of the call stack suitable for understanding execution flow.
+ *
+ * Direction options:
+ *  - 'callees' — what does this function call? (forward walk)
+ *  - 'callers' — what calls this function? (reverse walk)
+ *  - 'both'    — bidirectional tree: callers above root, callees below
+ *
+ * Cycle detection: recursive calls are included as leaf nodes with
+ * `cyclic: true` to prevent infinite expansion.
+ */
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "get_call_hierarchy";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    symbolId: z.ZodString;
+    direction: z.ZodEnum<{
+        both: "both";
+        callers: "callers";
+        callees: "callees";
+    }>;
+    maxDepth: z.ZodOptional<z.ZodNumber>;
+    maxNodes: z.ZodOptional<z.ZodNumber>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+};
+export declare function handler(args: {
+    repoId: string;
+    symbolId: string;
+    direction: 'callers' | 'callees' | 'both';
+    maxDepth?: number;
+    maxNodes?: number;
+    maxTokens?: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=get-call-hierarchy.d.ts.map

package/dist/server/tools/get-call-hierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-call-hierarchy.d.ts","sourceRoot":"","sources":["../../../src/server/tools/get-call-hierarchy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,IAAI,uBAAuB,CAAC;AAEzC,eAAO,MAAM,WAAW,QAK2C,CAAC;AAEpE,eAAO,MAAM,WAAW;;;;;;;;;;;CAuCvB,CAAC;AA2BF,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,cAAc,CAAC,CAoE1B"}

package/dist/server/tools/get-call-hierarchy.js

@@ -0,0 +1,119 @@
+/**
+ * get-call-hierarchy.ts
+ *
+ * MCP tool: get_call_hierarchy
+ *
+ * Return the callers and callees of a function, N levels deep, as a tree
+ * structure. Unlike get_blast_radius (file-level, reverse-only) and
+ * find_references (flat call sites), this tool returns a hierarchical view
+ * of the call stack suitable for understanding execution flow.
+ *
+ * Direction options:
+ *  - 'callees' — what does this function call? (forward walk)
+ *  - 'callers' — what calls this function? (reverse walk)
+ *  - 'both'    — bidirectional tree: callers above root, callees below
+ *
+ * Cycle detection: recursive calls are included as leaf nodes with
+ * `cyclic: true` to prevent infinite expansion.
+ */
+import { z } from 'zod';
+import { openDatabase, getRepo } from '../../core/db/schema.js';
+import { buildCallHierarchy } from '../../graph/graph-traversal.js';
+import { buildMeta } from './_meta.js';
+export const name = 'get_call_hierarchy';
+export const description = 'Return the callers and callees of a function, N levels deep, as a tree ' +
+    'structure. Use direction="callees" to see what a function calls, ' +
+    '"callers" to see what calls it, or "both" for a bidirectional view. ' +
+    'Recursive functions are detected and marked with cyclic=true. ' +
+    'Use search_symbols to find the symbolId for the function first.';
+export const inputSchema = {
+    repoId: z.string().describe('Repo ID from index_folder or resolve_repo'),
+    symbolId: z
+        .string()
+        .describe('Symbol ID of the function or method to build the hierarchy for'),
+    direction: z
+        .enum(['callers', 'callees', 'both'])
+        .describe('"callees" — what this function calls; ' +
+        '"callers" — what calls this function; ' +
+        '"both" — bidirectional (callers and callees combined at each level)'),
+    maxDepth: z
+        .number()
+        .int()
+        .min(1)
+        .max(6)
+        .optional()
+        .describe('Maximum tree depth (default 3, max 6)'),
+    maxNodes: z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .optional()
+        .describe('Stop expanding the tree once total nodes reach this count (default 50). ' +
+        'When hit, truncated=true is set in the response.'),
+    maxTokens: z
+        .number()
+        .int()
+        .min(100)
+        .optional()
+        .describe('Soft cap on response size in tokens. ' +
+        'When the estimated token count exceeds this value, the tree is returned as-is ' +
+        'with truncated=true.'),
+};
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export async function handler(args) {
+    const t0 = Date.now();
+    const { repoId, symbolId, direction, maxDepth = 3, maxNodes = 50, maxTokens, } = 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,
+            };
+        }
+        const result = buildCallHierarchy(symbolId, repoId, db, direction, maxDepth, maxNodes);
+        if (!result) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Symbol "${symbolId}" not found in repo "${repoId}".`,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const responseText = JSON.stringify(result.root);
+        const tokenEstimate = Math.ceil(responseText.length / 4);
+        let truncated = result.truncated;
+        if (maxTokens !== undefined && tokenEstimate > maxTokens) {
+            truncated = true;
+        }
+        const output = {
+            root: result.root,
+            direction: result.direction,
+            totalNodes: result.totalNodes,
+            truncated,
+            _tokenEstimate: tokenEstimate,
+            _meta: buildMeta({ timingMs: Date.now() - t0 }),
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=get-call-hierarchy.js.map

package/dist/server/tools/get-call-hierarchy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-call-hierarchy.js","sourceRoot":"","sources":["../../../src/server/tools/get-call-hierarchy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,MAAM,CAAC,MAAM,IAAI,GAAG,oBAAoB,CAAC;AAEzC,MAAM,CAAC,MAAM,WAAW,GACtB,yEAAyE;IACzE,mEAAmE;IACnE,sEAAsE;IACtE,gEAAgE;IAChE,iEAAiE,CAAC;AAEpE,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;IACxE,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,QAAQ,CAAC,gEAAgE,CAAC;IAC7E,SAAS,EAAE,CAAC;SACT,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;SACpC,QAAQ,CACP,wCAAwC;QACxC,wCAAwC;QACxC,qEAAqE,CACtE;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,CAAC,CAAC;SACN,QAAQ,EAAE;SACV,QAAQ,CAAC,uCAAuC,CAAC;IACpD,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,0EAA0E;QAC1E,kDAAkD,CACnD;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,uCAAuC;QACvC,gFAAgF;QAChF,sBAAsB,CACvB;CACJ,CAAC;AAyBF,iFAAiF;AAEjF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAO7B;IACC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,EACJ,MAAM,EACN,QAAQ,EACR,SAAS,EACT,QAAQ,GAAG,CAAC,EACZ,QAAQ,GAAG,EAAE,EACb,SAAS,GACV,GAAG,IAAI,CAAC;IAET,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEhC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,SAAS,MAAM,sCAAsC;yBAC7D,CAAC;qBACH;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEvF,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;4BACnB,KAAK,EAAE,WAAW,QAAQ,wBAAwB,MAAM,IAAI;yBAC7D,CAAC;qBACH;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QAED,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAEzD,IAAI,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QACjC,IAAI,SAAS,KAAK,SAAS,IAAI,aAAa,GAAG,SAAS,EAAE,CAAC;YACzD,SAAS,GAAG,IAAI,CAAC;QACnB,CAAC;QAED,MAAM,MAAM,GAA2B;YACrC,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS;YACT,cAAc,EAAE,aAAa;YAC7B,KAAK,EAAE,SAAS,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;SAChD,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/server/tools/get-class-hierarchy.d.ts

@@ -0,0 +1,36 @@
+/**
+ * get-class-hierarchy.ts
+ *
+ * MCP tool: get_class_hierarchy
+ *
+ * Return the full inheritance chain for a class or interface — ancestors
+ * (extends chain upward) and/or descendants (all subclasses downward).
+ *
+ * Detection strategy: signature-based LIKE queries on `symbols.signature`
+ * with word-boundary regex post-filtering. External base classes (e.g.
+ * `extends Error`) that are not indexed appear as leaf nodes with
+ * `symbolId: null`.
+ */
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "get_class_hierarchy";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    symbolId: z.ZodString;
+    direction: z.ZodOptional<z.ZodEnum<{
+        both: "both";
+        ancestors: "ancestors";
+        descendants: "descendants";
+    }>>;
+    maxDepth: z.ZodOptional<z.ZodNumber>;
+    includeInterfaces: z.ZodOptional<z.ZodBoolean>;
+};
+export declare function handler(args: {
+    repoId: string;
+    symbolId: string;
+    direction?: 'ancestors' | 'descendants' | 'both';
+    maxDepth?: number;
+    includeInterfaces?: boolean;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=get-class-hierarchy.d.ts.map

package/dist/server/tools/get-class-hierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-class-hierarchy.d.ts","sourceRoot":"","sources":["../../../src/server/tools/get-class-hierarchy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,IAAI,wBAAwB,CAAC;AAE1C,eAAO,MAAM,WAAW,QAKJ,CAAC;AAErB,eAAO,MAAM,WAAW;;;;;;;;;;CA0BvB,CAAC;AAIF,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,WAAW,GAAG,aAAa,GAAG,MAAM,CAAC;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,OAAO,CAAC,cAAc,CAAC,CAgG1B"}

package/dist/server/tools/get-class-hierarchy.js

@@ -0,0 +1,125 @@
+/**
+ * get-class-hierarchy.ts
+ *
+ * MCP tool: get_class_hierarchy
+ *
+ * Return the full inheritance chain for a class or interface — ancestors
+ * (extends chain upward) and/or descendants (all subclasses downward).
+ *
+ * Detection strategy: signature-based LIKE queries on `symbols.signature`
+ * with word-boundary regex post-filtering. External base classes (e.g.
+ * `extends Error`) that are not indexed appear as leaf nodes with
+ * `symbolId: null`.
+ */
+import { z } from 'zod';
+import { openDatabase, getRepo } from '../../core/db/schema.js';
+import { getSymbolById } from '../../core/db/symbol-store.js';
+import { buildClassHierarchy } from '../../graph/graph-traversal.js';
+import { buildMeta } from './_meta.js';
+export const name = 'get_class_hierarchy';
+export const description = 'Return the full inheritance chain for a class or interface — ancestors ' +
+    '(extends chain upward) and/or descendants (all subclasses/implementations ' +
+    'downward). External base classes not in the repo appear as leaf nodes with ' +
+    'symbolId: null. Use search_symbols to find the symbolId for a class or ' +
+    'interface first.';
+export const inputSchema = {
+    repoId: z.string().describe('Repo ID from index_folder or resolve_repo'),
+    symbolId: z
+        .string()
+        .describe('Symbol ID of the class or interface to root the hierarchy at'),
+    direction: z
+        .enum(['ancestors', 'descendants', 'both'])
+        .optional()
+        .describe('Which direction to traverse: "ancestors" (extends chain upward), ' +
+        '"descendants" (all subclasses downward), or "both" (default: "both")'),
+    maxDepth: z
+        .number()
+        .int()
+        .min(1)
+        .max(10)
+        .optional()
+        .describe('Maximum traversal depth in each direction (default 5)'),
+    includeInterfaces: z
+        .boolean()
+        .optional()
+        .describe('Include implemented interfaces in the ancestor chain and interface ' +
+        'subclasses in descendants (default true)'),
+};
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export async function handler(args) {
+    const t0 = Date.now();
+    const { repoId, symbolId, direction = 'both', maxDepth = 5, includeInterfaces = true, } = 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,
+            };
+        }
+        const target = getSymbolById(db, repoId, symbolId);
+        if (!target) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Symbol "${symbolId}" not found in repo "${repoId}".`,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        if (target.kind !== 'class' && target.kind !== 'interface') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Symbol "${target.name}" has kind "${target.kind}". ` +
+                                'get_class_hierarchy only works with class or interface symbols.',
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const result = buildClassHierarchy(symbolId, repoId, db, direction, maxDepth, includeInterfaces);
+        if (!result) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Symbol "${symbolId}" not found during hierarchy traversal.`,
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const responseText = JSON.stringify(result.root);
+        const output = {
+            root: result.root,
+            totalNodes: result.totalNodes,
+            _tokenEstimate: Math.ceil(responseText.length / 4),
+            _meta: buildMeta({ timingMs: Date.now() - t0 }),
+        };
+        return {
+            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=get-class-hierarchy.js.map

package/dist/server/tools/get-class-hierarchy.js.map

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