purecontext-mcp 1.1.8 → 1.2.0

package/dist/server/tools/diff-health-radar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-health-radar.d.ts","sourceRoot":"","sources":["../../../src/server/tools/diff-health-radar.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAIzE,eAAO,MAAM,IAAI,sBAAsB,CAAC;AAExC,eAAO,MAAM,WAAW,QAMwB,CAAC;AAEjD,eAAO,MAAM,WAAW;;;;;CAqBvB,CAAC;AAkGF,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,GAAG,OAAO,CAAC,cAAc,CAAC,CAuH1B"}

package/dist/server/tools/diff-health-radar.js

@@ -0,0 +1,192 @@
+/**
+ * diff-health-radar.ts
+ *
+ * MCP tool: diff_health_radar
+ *
+ * Compare health radar scores between two indexed repos (or two states of the
+ * same codebase). Primary use cases:
+ *
+ *   • PR review: index main branch → index feature branch → compare
+ *   • Refactoring validation: index before → refactor → re-index → compare
+ *   • Cross-repo benchmark: compare health of two different projects
+ *
+ * Runs health_radar on both repos, then computes per-axis deltas (head − base).
+ * Positive delta = improvement; negative delta = regression.
+ *
+ * Output:
+ *   • base snapshot — health scores from baseRepoId
+ *   • head snapshot — health scores from headRepoId
+ *   • axes delta map — score change per axis with trend label
+ *   • overallDelta — change in overall health (head − base)
+ *   • trend — 'improved' | 'degraded' | 'stable' (based on overallDelta)
+ *   • regressions — axis names that degraded by > SIGNIFICANT_DELTA
+ *   • improvements — axis names that improved by > SIGNIFICANT_DELTA
+ *
+ * A delta of +5 or more is treated as a meaningful improvement.
+ * A delta of −5 or more (negative) is treated as a meaningful regression.
+ */
+import { z } from 'zod';
+import { handler as healthRadarHandler } from './health-radar.js';
+import { buildMeta } from './_meta.js';
+// ─── Tool exports ─────────────────────────────────────────────────────────────
+export const name = 'diff_health_radar';
+export const description = 'Compare health radar scores between two indexed repos (or two states of the same codebase). ' +
+    'Runs health_radar on baseRepoId and headRepoId, then computes per-axis deltas. ' +
+    'Positive delta = improvement; negative delta = regression. ' +
+    'Primary use cases: PR review (index main vs feature branch), refactoring validation ' +
+    '(index before/after), and cross-repo health benchmarking. ' +
+    'Use health_radar for a single-repo snapshot.';
+export const inputSchema = {
+    baseRepoId: z
+        .string()
+        .describe('Baseline repo ID (e.g. main branch). From index_folder or resolve_repo.'),
+    headRepoId: z
+        .string()
+        .describe('Head repo ID to compare against the baseline (e.g. feature branch).'),
+    scope: z
+        .string()
+        .optional()
+        .describe('Directory prefix filter applied to both repos (e.g. "src/core/"). ' +
+        'Narrows analysis to the same subtree in each repo.'),
+    includeStability: z
+        .boolean()
+        .optional()
+        .describe('Include churn-based stability axis in both snapshots (requires git metadata; default true). ' +
+        'Set false to skip git queries when git data is absent.'),
+};
+// ─── Constants ────────────────────────────────────────────────────────────────
+const SIGNIFICANT_DELTA = 5; // Minimum delta (absolute) to count as meaningful
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function toTrend(delta) {
+    if (delta >= SIGNIFICANT_DELTA)
+        return 'improved';
+    if (delta <= -SIGNIFICANT_DELTA)
+        return 'degraded';
+    return 'stable';
+}
+function parseSnapshot(result, repoId) {
+    if (result.isError)
+        return null;
+    const text = result.content[0]?.text;
+    if (!text)
+        return null;
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        return null;
+    }
+}
+const AXIS_NAMES = [
+    'complexity',
+    'coupling',
+    'maintainability',
+    'documentation',
+    'stability',
+];
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export async function handler(args) {
+    const t0 = Date.now();
+    const { baseRepoId, headRepoId, scope, includeStability = true } = args;
+    // ── Run health_radar on both repos in parallel ────────────────────────────
+    const [baseResult, headResult] = await Promise.all([
+        healthRadarHandler({ repoId: baseRepoId, scope, includeStability }),
+        healthRadarHandler({ repoId: headRepoId, scope, includeStability }),
+    ]);
+    // ── Validate both succeeded ────────────────────────────────────────────────
+    const baseJson = parseSnapshot(baseResult, baseRepoId);
+    const headJson = parseSnapshot(headResult, headRepoId);
+    if (!baseJson) {
+        // Forward the base error
+        if (baseResult.isError)
+            return baseResult;
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: `Failed to compute health radar for base repo "${baseRepoId}"` }) }],
+            isError: true,
+        };
+    }
+    if (!headJson) {
+        // Forward the head error
+        if (headResult.isError)
+            return headResult;
+        return {
+            content: [{ type: 'text', text: JSON.stringify({ error: `Failed to compute health radar for head repo "${headRepoId}"` }) }],
+            isError: true,
+        };
+    }
+    // ── Compute per-axis deltas ────────────────────────────────────────────────
+    const axes = {};
+    const regressions = [];
+    const improvements = [];
+    for (const axisName of AXIS_NAMES) {
+        const baseAxis = baseJson.axes[axisName];
+        const headAxis = headJson.axes[axisName];
+        const baseScore = baseAxis.score;
+        const headScore = headAxis.score;
+        const delta = headScore - baseScore;
+        const trend = toTrend(delta);
+        axes[axisName] = {
+            baseScore,
+            headScore,
+            delta,
+            trend,
+            baseAvailable: baseAxis.available,
+            headAvailable: headAxis.available,
+        };
+        if (trend === 'degraded')
+            regressions.push(axisName);
+        if (trend === 'improved')
+            improvements.push(axisName);
+    }
+    // ── Overall delta and trend ────────────────────────────────────────────────
+    const overallDelta = headJson.overallHealth - baseJson.overallHealth;
+    const trend = toTrend(overallDelta);
+    // ── Snapshots (subset for output) ─────────────────────────────────────────
+    const base = {
+        repoId: baseRepoId,
+        overallHealth: baseJson.overallHealth,
+        grade: baseJson.grade,
+        axes: baseJson.axes,
+        gitDataAvailable: baseJson.summary.gitDataAvailable,
+    };
+    const head = {
+        repoId: headRepoId,
+        overallHealth: headJson.overallHealth,
+        grade: headJson.grade,
+        axes: headJson.axes,
+        gitDataAvailable: headJson.summary.gitDataAvailable,
+    };
+    // ── Summary ────────────────────────────────────────────────────────────────
+    const axesCompared = AXIS_NAMES.filter((n) => axes[n].baseAvailable || axes[n].headAvailable).length;
+    const gradeChange = base.grade === head.grade
+        ? base.grade
+        : `${base.grade} → ${head.grade}`;
+    const output = {
+        baseRepoId,
+        headRepoId,
+        scope,
+        generatedAt: new Date().toISOString(),
+        base,
+        head,
+        axes,
+        overallDelta,
+        trend,
+        regressions,
+        improvements,
+        summary: {
+            axesCompared,
+            regressionCount: regressions.length,
+            improvementCount: improvements.length,
+            stableCount: AXIS_NAMES.length - regressions.length - improvements.length,
+            overallGradeChange: gradeChange,
+        },
+        _tokenEstimate: 0,
+        _meta: buildMeta({ timingMs: Date.now() - t0 }),
+    };
+    const text = JSON.stringify(output, null, 2);
+    output._tokenEstimate = Math.ceil(text.length / 4);
+    return {
+        content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+    };
+}
+//# sourceMappingURL=diff-health-radar.js.map

package/dist/server/tools/diff-health-radar.js.map

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

package/dist/server/tools/find-cycles.d.ts

@@ -0,0 +1,31 @@
+/**
+ * find-cycles.ts
+ *
+ * MCP tool: find_cycles
+ *
+ * Detect all import cycles in the dependency graph and return them as ordered
+ * file paths. Unlike detect_antipatterns (which reports only a count and
+ * severity), this tool returns the actual cycle paths so an agent can understand
+ * and resolve circular dependencies.
+ *
+ * Algorithm: DFS with path stack. Each cycle is reported exactly once, rooted
+ * at its lexicographically smallest file. Severity is 'error' for tight 2–3-node
+ * cycles (tightly coupled pairs/triangles) and 'warning' for longer chains.
+ */
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "find_cycles";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    filePath: z.ZodOptional<z.ZodString>;
+    maxCycles: z.ZodOptional<z.ZodNumber>;
+    minLength: z.ZodOptional<z.ZodNumber>;
+};
+export declare function handler(args: {
+    repoId: string;
+    filePath?: string;
+    maxCycles?: number;
+    minLength?: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=find-cycles.d.ts.map

package/dist/server/tools/find-cycles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-cycles.d.ts","sourceRoot":"","sources":["../../../src/server/tools/find-cycles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,eAAO,MAAM,IAAI,gBAAgB,CAAC;AAElC,eAAO,MAAM,WAAW,QAK0D,CAAC;AAEnF,eAAO,MAAM,WAAW;;;;;CA0BvB,CAAC;AAoBF,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,cAAc,CAAC,CAuC1B"}

package/dist/server/tools/find-cycles.js

@@ -0,0 +1,85 @@
+/**
+ * find-cycles.ts
+ *
+ * MCP tool: find_cycles
+ *
+ * Detect all import cycles in the dependency graph and return them as ordered
+ * file paths. Unlike detect_antipatterns (which reports only a count and
+ * severity), this tool returns the actual cycle paths so an agent can understand
+ * and resolve circular dependencies.
+ *
+ * Algorithm: DFS with path stack. Each cycle is reported exactly once, rooted
+ * at its lexicographically smallest file. Severity is 'error' for tight 2–3-node
+ * cycles (tightly coupled pairs/triangles) and 'warning' for longer chains.
+ */
+import { z } from 'zod';
+import { openDatabase, getRepo } from '../../core/db/schema.js';
+import { findImportCycles } from '../../graph/graph-traversal.js';
+import { buildMeta } from './_meta.js';
+export const name = 'find_cycles';
+export const description = 'Detect all import cycles in the dependency graph and return them as ordered ' +
+    'file paths. Unlike detect_antipatterns (which only counts cycles), this tool ' +
+    'returns the actual cycle paths so you can understand and resolve circular ' +
+    'dependencies. Severity is "error" for tight 2–3 node cycles and "warning" ' +
+    'for longer chains. Use filePath to scope results to cycles involving one file.';
+export const inputSchema = {
+    repoId: z.string().describe('Repo ID from index_folder or resolve_repo'),
+    filePath: z
+        .string()
+        .optional()
+        .describe('Scope to cycles that involve this file (relative to repo root). ' +
+        'If omitted, all cycles in the repo are returned up to maxCycles.'),
+    maxCycles: z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .optional()
+        .describe('Stop after finding this many cycles (default 20)'),
+    minLength: z
+        .number()
+        .int()
+        .min(2)
+        .max(20)
+        .optional()
+        .describe('Minimum cycle length to report (default 2). ' +
+        'A mutual import A→B→A has length 2. Raise this to skip direct pairs.'),
+};
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export async function handler(args) {
+    const t0 = Date.now();
+    const { repoId, filePath, maxCycles = 20, minLength = 2 } = 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 = findImportCycles(repoId, db, filePath, maxCycles, minLength);
+        const responseText = JSON.stringify(result.cycles);
+        const output = {
+            cycles: result.cycles,
+            totalFound: result.totalFound,
+            truncated: result.truncated,
+            _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=find-cycles.js.map

package/dist/server/tools/find-cycles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-cycles.js","sourceRoot":"","sources":["../../../src/server/tools/find-cycles.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAGvC,MAAM,CAAC,MAAM,IAAI,GAAG,aAAa,CAAC;AAElC,MAAM,CAAC,MAAM,WAAW,GACtB,8EAA8E;IAC9E,+EAA+E;IAC/E,4EAA4E;IAC5E,4EAA4E;IAC5E,gFAAgF,CAAC;AAEnF,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,EAAE;SACV,QAAQ,CACP,kEAAkE;QAClE,kEAAkE,CACnE;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,kDAAkD,CAAC;IAC/D,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,EAAE;SACV,QAAQ,CACP,8CAA8C;QAC9C,sEAAsE,CACvE;CACJ,CAAC;AAkBF,iFAAiF;AAEjF,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAK7B;IACC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACtB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,GAAG,EAAE,EAAE,SAAS,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC;IAEjE,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,gBAAgB,CAAC,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;QAE5E,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnD,MAAM,MAAM,GAAqB;YAC/B,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,cAAc,EAAE,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;YAClD,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/find-implementations.d.ts

@@ -0,0 +1,47 @@
+/**
+ * find-implementations.ts
+ *
+ * MCP tool: find_implementations
+ *
+ * Find all concrete implementations of a TypeScript interface or abstract class,
+ * and all method overrides for a given base method.
+ *
+ * Detection strategy (two-pass):
+ *  1. Name-based: search class symbols whose signature contains
+ *     `implements InterfaceName` or `extends ClassName` via LIKE on symbols.signature.
+ *  2. Import-based: any file that imports the interface's file is also scanned
+ *     for classes that match, catching cases where the name-based pass missed due
+ *     to signature truncation.
+ *
+ * `implementedMethods` / `missingMethods` are computed by comparing the method
+ * symbols stored under the interface name against those stored under the
+ * implementing class name.
+ */
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "find_implementations";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    symbolId: z.ZodString;
+    includeAbstract: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+};
+export interface ImplementationRecord {
+    symbolId: string;
+    name: string;
+    kind: string;
+    filePath: string;
+    startLine: number;
+    signature: string;
+    summary: string;
+    implementedMethods: string[];
+    missingMethods: string[];
+}
+export declare function handler(args: {
+    repoId: string;
+    symbolId: string;
+    includeAbstract?: boolean;
+    limit?: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=find-implementations.d.ts.map

package/dist/server/tools/find-implementations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-implementations.d.ts","sourceRoot":"","sources":["../../../src/server/tools/find-implementations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,eAAO,MAAM,IAAI,yBAAyB,CAAC;AAE3C,eAAO,MAAM,WAAW,QAI6D,CAAC;AAEtF,eAAO,MAAM,WAAW;;;;;CAmBvB,CAAC;AAIF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAyBD,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,cAAc,CAAC,CAgI1B"}

package/dist/server/tools/find-implementations.js

@@ -0,0 +1,167 @@
+/**
+ * find-implementations.ts
+ *
+ * MCP tool: find_implementations
+ *
+ * Find all concrete implementations of a TypeScript interface or abstract class,
+ * and all method overrides for a given base method.
+ *
+ * Detection strategy (two-pass):
+ *  1. Name-based: search class symbols whose signature contains
+ *     `implements InterfaceName` or `extends ClassName` via LIKE on symbols.signature.
+ *  2. Import-based: any file that imports the interface's file is also scanned
+ *     for classes that match, catching cases where the name-based pass missed due
+ *     to signature truncation.
+ *
+ * `implementedMethods` / `missingMethods` are computed by comparing the method
+ * symbols stored under the interface name against those stored under the
+ * implementing class name.
+ */
+import { z } from 'zod';
+import { openDatabase, getRepo } from '../../core/db/schema.js';
+import { getSymbolById } from '../../core/db/symbol-store.js';
+import { findClassImplementations, getMethodNamesForSymbol, extractInterfaceMethodNames, } from '../../core/db/dep-store.js';
+import { buildMeta } from './_meta.js';
+import { getFileContent } from '../../core/db/file-store.js';
+export const name = 'find_implementations';
+export const description = 'Find all concrete implementations of a TypeScript interface or abstract class, ' +
+    'and all method overrides for a given base method. ' +
+    'Returns implementing classes with their implemented and missing methods. ' +
+    'Use search_symbols to find the symbolId for an interface or abstract class first.';
+export const inputSchema = {
+    repoId: z.string().describe('Repo ID from index_folder or resolve_repo'),
+    symbolId: z
+        .string()
+        .describe('Symbol ID of the interface or abstract class to search for'),
+    includeAbstract: z
+        .boolean()
+        .optional()
+        .describe('Include abstract subclasses in results (default false). ' +
+        'When true, abstract classes that extend the target are included alongside concrete implementations.'),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(200)
+        .optional()
+        .describe('Maximum number of implementations to return (default 50)'),
+};
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+/** Compute 1-based line number from a byte/char offset within file content. */
+function byteToLine(content, offset) {
+    const slice = content.slice(0, Math.min(offset, content.length));
+    let line = 1;
+    for (let i = 0; i < slice.length; i++) {
+        if (slice[i] === 0x0a)
+            line++;
+    }
+    return line;
+}
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export async function handler(args) {
+    const t0 = Date.now();
+    const { repoId, symbolId, includeAbstract = false, limit = 50 } = 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,
+            };
+        }
+        // Look up the target interface / abstract class
+        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 !== 'interface' && target.kind !== 'class') {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify({
+                            error: `Symbol "${target.name}" has kind "${target.kind}". ` +
+                                'find_implementations only works with interface or class symbols.',
+                        }),
+                    },
+                ],
+                isError: true,
+            };
+        }
+        // Get interface/abstract-class method names.
+        // Interface methods are NOT indexed as separate symbols by the TypeScript handler,
+        // so we extract them from the raw file content using the target's byte range.
+        // For abstract classes, the indexed method symbols are used as fallback.
+        let interfaceMethods;
+        const targetFileContent = getFileContent(db, repoId, target.filePath);
+        if (targetFileContent) {
+            interfaceMethods = extractInterfaceMethodNames(targetFileContent, target.startByte, target.endByte);
+        }
+        else {
+            // Fallback to indexed method symbols (works for abstract classes)
+            interfaceMethods = getMethodNamesForSymbol(db, repoId, target.name, target.filePath);
+        }
+        // Find all classes/interfaces that implement or extend this target
+        const implementors = findClassImplementations(db, repoId, target.name, target.filePath, includeAbstract, limit);
+        // Build ImplementationRecord for each implementor
+        const implementations = [];
+        for (const impl of implementors) {
+            // Get the implementing class's method stems
+            const classMethods = getMethodNamesForSymbol(db, repoId, impl.name, impl.filePath);
+            const classMethodSet = new Set(classMethods);
+            const implementedMethods = interfaceMethods.filter((m) => classMethodSet.has(m));
+            const missingMethods = interfaceMethods.filter((m) => !classMethodSet.has(m));
+            // Compute startLine from file content
+            let startLine = 1;
+            const fileContent = getFileContent(db, repoId, impl.filePath);
+            if (fileContent) {
+                startLine = byteToLine(fileContent, impl.startByte);
+            }
+            implementations.push({
+                symbolId: impl.id,
+                name: impl.name,
+                kind: impl.kind,
+                filePath: impl.filePath,
+                startLine,
+                signature: impl.signature,
+                summary: impl.summary,
+                implementedMethods,
+                missingMethods,
+            });
+        }
+        const responseText = JSON.stringify(implementations);
+        const output = {
+            interfaceName: target.name,
+            interfaceFilePath: target.filePath,
+            implementations,
+            totalFound: implementations.length,
+            _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=find-implementations.js.map

package/dist/server/tools/find-implementations.js.map

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

package/dist/server/tools/find-untested-symbols.d.ts

@@ -0,0 +1,52 @@
+/**
+ * find-untested-symbols.ts
+ *
+ * MCP tool: find_untested_symbols
+ *
+ * Identifies exported symbols (functions, methods, classes, etc.) in the
+ * codebase that do not appear to have any test coverage — i.e. whose names
+ * are not referenced in any test file.
+ *
+ * Detection strategy (static heuristic):
+ *   1. Identify test files by path convention:
+ *      - Path segment is "test", "tests", "spec", "specs", or "__tests__"
+ *      - Filename ends with .test.*, .spec.*, _test.*, or _spec.*
+ *   2. Extract all identifiers referenced in those test files.
+ *   3. Any non-test symbol whose name does NOT appear in the test identifier
+ *      set is considered "untested".
+ *
+ * Limitations:
+ *   - Name-based matching only; dynamic dispatch, aliases, and indirect calls
+ *     can produce false negatives (symbol appears tested when it is not) or
+ *     false positives (common names like `get` match unrelated things).
+ *   - Does not read coverage reports; for accurate coverage, pipe in a
+ *     coverage JSON file via get_test_coverage_map instead.
+ *
+ * Priority rating (per untested symbol):
+ *   high   — cyclomatic_complexity >= 5 OR line_count >= 20
+ *   medium — cyclomatic_complexity >= 2 OR line_count >= 8
+ *   low    — all other symbols
+ */
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "find_untested_symbols";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    scope: z.ZodOptional<z.ZodString>;
+    kinds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    filePath: z.ZodOptional<z.ZodString>;
+    minLineCount: z.ZodOptional<z.ZodNumber>;
+    includeTestRefs: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+};
+export declare function handler(args: {
+    repoId: string;
+    scope?: string;
+    kinds?: string[];
+    filePath?: string;
+    minLineCount?: number;
+    includeTestRefs?: boolean;
+    limit?: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=find-untested-symbols.d.ts.map

package/dist/server/tools/find-untested-symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-untested-symbols.d.ts","sourceRoot":"","sources":["../../../src/server/tools/find-untested-symbols.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,eAAO,MAAM,IAAI,0BAA0B,CAAC;AAE5C,eAAO,MAAM,WAAW,QAYyD,CAAC;AAQlF,eAAO,MAAM,WAAW;;;;;;;;CAsCvB,CAAC;AA4FF,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,cAAc,CAAC,CAoN1B"}