purecontext-mcp 1.1.7 → 1.2.0

package/dist/server/tools/get-public-api.js

@@ -0,0 +1,218 @@
+/**
+ * get-public-api.ts
+ *
+ * MCP tool: get_public_api
+ *
+ * Returns the public API surface of a repository: all exported symbols, grouped
+ * by file. A symbol is "public" when its signature begins with the `export`
+ * keyword (TypeScript/JavaScript export declarations, re-exports included).
+ *
+ * Designed for:
+ *   - Onboarding: "what does this library expose?"
+ *   - API contract review: "has the surface changed between snapshots?"
+ *   - Documentation seeding: enumerate exports to generate docs
+ *   - Dependency analysis: know what consumers can legally import
+ *
+ * Use find_dead_code to find exported symbols that nobody imports.
+ * Use get_blast_radius before removing an export to understand downstream impact.
+ */
+import { z } from 'zod';
+import { openDatabase, getRepo } from '../../core/db/schema.js';
+import { buildMeta } from './_meta.js';
+export const name = 'get_public_api';
+export const description = 'Return the public API surface of a repository: all exported symbols, grouped by file. ' +
+    'A symbol is considered public when its signature begins with the export keyword. ' +
+    'Use this to answer "what does this library expose?", audit API contracts, seed ' +
+    'documentation, or compare the public surface before and after a refactor. ' +
+    'Each result includes symbolId, name, kind, signature, summary, file path, and ' +
+    'whether the symbol is a default export.' +
+    '\n\nRelated tools:' +
+    '\n  find_dead_code   — exported symbols that nobody imports' +
+    '\n  get_blast_radius — downstream impact of removing an export' +
+    '\n  get_repo_outline — all symbols (exported and unexported) by file';
+export const inputSchema = {
+    repoId: z.string().describe('Repository ID returned by index_folder or list_repos'),
+    filePath: z
+        .string()
+        .optional()
+        .describe('Restrict to a specific file path or directory prefix ' +
+        '(e.g. "src/services/" returns all exports from that subtree)'),
+    kind: z
+        .enum([
+        'function', 'class', 'method', 'const', 'type', 'interface', 'enum',
+        'component', 'composable', 'hook', 'route', 'decorator', 'middleware',
+    ])
+        .optional()
+        .describe('Filter results to a specific symbol kind'),
+    includeMembers: z
+        .boolean()
+        .optional()
+        .describe('When true, also include public methods of exported classes. ' +
+        'Methods do not carry the export keyword themselves but are part of the exported ' +
+        'API surface. Only effective when kind is not set (default false).'),
+    groupByFile: z
+        .boolean()
+        .optional()
+        .describe('Group results by file (default true). Set false for a flat sorted list.'),
+    limit: z
+        .number().int().positive().optional()
+        .describe('Maximum number of exported symbols to return (default 500)'),
+};
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export async function handler(args) {
+    const t0 = Date.now();
+    const { repoId, includeMembers = false, groupByFile = true, limit = 500, } = args;
+    const db = openDatabase(repoId);
+    try {
+        // ── Validate repo exists ───────────────────────────────────────────────────
+        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,
+            };
+        }
+        // ── Query exported symbols ─────────────────────────────────────────────────
+        // A symbol is exported if its signature begins with "export"
+        const conditions = [
+            'repo_id = @repoId',
+            "(signature LIKE 'export %' OR signature LIKE 'export' OR signature LIKE 'export\n%')",
+        ];
+        const params = { repoId };
+        if (args.kind) {
+            conditions.push('kind = @kind');
+            params['kind'] = args.kind;
+        }
+        if (args.filePath) {
+            conditions.push('(file_path = @filePath OR file_path LIKE @filePathPrefix)');
+            params['filePath'] = args.filePath;
+            params['filePathPrefix'] = `${args.filePath}%`;
+        }
+        params['limit'] = limit;
+        const exportedSql = `
+      SELECT id, name, kind, file_path, start_byte, signature, summary
+      FROM symbols
+      WHERE ${conditions.join(' AND ')}
+      ORDER BY file_path ASC, start_byte ASC
+      LIMIT @limit
+    `;
+        const rows = db
+            .prepare(exportedSql)
+            .all(params);
+        // ── Optionally include methods of exported classes ─────────────────────────
+        if (includeMembers && !args.kind) {
+            const exportedClassFiles = new Set(rows
+                .filter((r) => r.kind === 'class' || r.kind === 'component')
+                .map((r) => r.file_path));
+            if (exportedClassFiles.size > 0) {
+                const existingIds = new Set(rows.map((r) => r.id));
+                const fileList = Array.from(exportedClassFiles);
+                const placeholders = fileList.map((_, i) => `@fp${i}`).join(', ');
+                const memberParams = { repoId };
+                fileList.forEach((fp, i) => { memberParams[`fp${i}`] = fp; });
+                const memberSql = `
+          SELECT id, name, kind, file_path, start_byte, signature, summary
+          FROM symbols
+          WHERE repo_id = @repoId
+            AND kind = 'method'
+            AND file_path IN (${placeholders})
+          ORDER BY file_path ASC, start_byte ASC
+        `;
+                const memberRows = db
+                    .prepare(memberSql)
+                    .all(memberParams);
+                for (const r of memberRows) {
+                    if (!existingIds.has(r.id)) {
+                        rows.push(r);
+                    }
+                }
+                rows.sort((a, b) => a.file_path.localeCompare(b.file_path) || a.start_byte - b.start_byte);
+            }
+        }
+        // ── Compute startLine from stored file content ─────────────────────────────
+        const fileSymbols = new Map();
+        for (const row of rows) {
+            const list = fileSymbols.get(row.file_path) ?? [];
+            list.push(row);
+            fileSymbols.set(row.file_path, list);
+        }
+        const lineMap = new Map();
+        let rawBytes = 0;
+        for (const [filePath, syms] of fileSymbols) {
+            const fileRow = db
+                .prepare('SELECT raw_content FROM files WHERE repo_id = ? AND path = ?')
+                .get(repoId, filePath);
+            if (fileRow?.raw_content) {
+                rawBytes += fileRow.raw_content.length;
+                const content = fileRow.raw_content;
+                for (const sym of syms) {
+                    const slice = content.slice(0, Math.min(sym.start_byte, content.length));
+                    let line = 1;
+                    for (let i = 0; i < slice.length; i++) {
+                        if (slice[i] === 0x0a)
+                            line++;
+                    }
+                    lineMap.set(sym.id, line);
+                }
+            }
+            else {
+                for (const sym of syms) {
+                    lineMap.set(sym.id, Math.max(1, Math.floor(sym.start_byte / 80) + 1));
+                }
+            }
+        }
+        // ── Shape symbols ─────────────────────────────────────────────────────────
+        const shaped = rows.map((row) => ({
+            symbolId: row.id,
+            name: row.name,
+            kind: row.kind,
+            filePath: row.file_path,
+            startLine: lineMap.get(row.id) ?? 1,
+            signature: row.signature,
+            summary: row.summary,
+            isDefault: row.signature.includes('export default'),
+        }));
+        const responseBytes = shaped.reduce((sum, s) => sum + s.signature.length + s.summary.length + s.filePath.length + 80, 0);
+        const tokenEstimate = Math.ceil(responseBytes / 4);
+        // ── Format output ─────────────────────────────────────────────────────────
+        const uniqueFileCount = fileSymbols.size;
+        let output;
+        if (groupByFile) {
+            const byFile = new Map();
+            for (const sym of shaped) {
+                const list = byFile.get(sym.filePath) ?? [];
+                list.push(sym);
+                byFile.set(sym.filePath, list);
+            }
+            const files = Array.from(byFile.entries())
+                .sort(([a], [b]) => a.localeCompare(b))
+                .map(([filePath, exports]) => ({ filePath, exports }));
+            output = {
+                totalExported: shaped.length,
+                fileCount: files.length,
+                files,
+                _tokenEstimate: tokenEstimate,
+                _meta: buildMeta({ timingMs: Date.now() - t0, rawBytes, responseBytes }),
+            };
+        }
+        else {
+            output = {
+                totalExported: shaped.length,
+                fileCount: uniqueFileCount,
+                symbols: shaped,
+                _tokenEstimate: tokenEstimate,
+                _meta: buildMeta({ timingMs: Date.now() - t0, rawBytes, responseBytes }),
+            };
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(output, null, 2) }],
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=get-public-api.js.map

package/dist/server/tools/get-public-api.js.map

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

package/dist/server/tools/get-savings-stats.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-savings-stats.d.ts","sourceRoot":"","sources":["../../../src/server/tools/get-savings-stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAWzE,eAAO,MAAM,IAAI,sBAAsB,CAAC;AAExC,eAAO,MAAM,WAAW,QAGiC,CAAC;AAE1D,eAAO,MAAM,WAAW;;CAMvB,CAAC;AAIF,wBAAgB,OAAO,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,CAyCjE"}
+{"version":3,"file":"get-savings-stats.d.ts","sourceRoot":"","sources":["../../../src/server/tools/get-savings-stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAWzE,eAAO,MAAM,IAAI,sBAAsB,CAAC;AAExC,eAAO,MAAM,WAAW,QAGiC,CAAC;AAE1D,eAAO,MAAM,WAAW;;CAMvB,CAAC;AAIF,wBAAgB,OAAO,CAAC,IAAI,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,cAAc,CAuCjE"}

package/dist/server/tools/get-savings-stats.js

@@ -1,5 +1,5 @@
 import { z } from 'zod';
-import { getTotalSaved, resetSavings, getSessionStart, costAvoided, } from '../../core/token-tracker.js';
+import { getTotalSaved, resetSavings, getSessionStart, } from '../../core/token-tracker.js';
 // ─── Context window sizes (in tokens) ────────────────────────────────────────
 const CONTEXT_WINDOWS = {
     claude_200k: 200_000,
@@ -31,7 +31,6 @@ export function handler(args) {
         };
     }
     const total = getTotalSaved();
-    const { total_cost_avoided } = costAvoided(total, total);
     const equivalent_context_windows = {};
     for (const [label, size] of Object.entries(CONTEXT_WINDOWS)) {
         equivalent_context_windows[label] = parseFloat((total / size).toFixed(2));
@@ -43,7 +42,6 @@ export function handler(args) {
                 text: JSON.stringify({
                     total_tokens_saved: total,
                     equivalent_context_windows,
-                    total_cost_avoided,
                     session_start: getSessionStart().toISOString(),
                     _meta: {
                         powered_by: 'PureContext MCP',

package/dist/server/tools/get-savings-stats.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-savings-stats.js","sourceRoot":"","sources":["../../../src/server/tools/get-savings-stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,eAAe,EACf,WAAW,GACZ,MAAM,6BAA6B,CAAC;AAGrC,gFAAgF;AAEhF,MAAM,eAAe,GAAG;IACtB,WAAW,EAAE,OAAO;IACpB,SAAS,EAAE,OAAO;CACV,CAAC;AAEX,iFAAiF;AAEjF,MAAM,CAAC,MAAM,IAAI,GAAG,mBAAmB,CAAC;AAExC,MAAM,CAAC,MAAM,WAAW,GACtB,4EAA4E;IAC5E,2FAA2F;IAC3F,uDAAuD,CAAC;AAE1D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,4DAA4D,CAAC;CAC1E,CAAC;AAEF,iFAAiF;AAEjF,MAAM,UAAU,OAAO,CAAC,IAAyB;IAC/C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;QAChC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACzE;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,MAAM,EAAE,kBAAkB,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IAEzD,MAAM,0BAA0B,GAA2B,EAAE,CAAC;IAC9D,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAC5D,0BAA0B,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,kBAAkB,EAAE,KAAK;oBACzB,0BAA0B;oBAC1B,kBAAkB;oBAClB,aAAa,EAAE,eAAe,EAAE,CAAC,WAAW,EAAE;oBAC9C,KAAK,EAAE;wBACL,UAAU,EAAE,iBAAiB;qBAC9B;iBACF,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"get-savings-stats.js","sourceRoot":"","sources":["../../../src/server/tools/get-savings-stats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,eAAe,GAChB,MAAM,6BAA6B,CAAC;AAGrC,gFAAgF;AAEhF,MAAM,eAAe,GAAG;IACtB,WAAW,EAAE,OAAO;IACpB,SAAS,EAAE,OAAO;CACV,CAAC;AAEX,iFAAiF;AAEjF,MAAM,CAAC,MAAM,IAAI,GAAG,mBAAmB,CAAC;AAExC,MAAM,CAAC,MAAM,WAAW,GACtB,4EAA4E;IAC5E,2FAA2F;IAC3F,uDAAuD,CAAC;AAE1D,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,KAAK,EAAE,CAAC;SACL,OAAO,EAAE;SACT,QAAQ,EAAE;SACV,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,4DAA4D,CAAC;CAC1E,CAAC;AAEF,iFAAiF;AAEjF,MAAM,UAAU,OAAO,CAAC,IAAyB;IAC/C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,MAAM,QAAQ,GAAG,YAAY,EAAE,CAAC;QAChC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;iBACzE;aACF;SACF,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAE9B,MAAM,0BAA0B,GAA2B,EAAE,CAAC;IAC9D,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,CAAC;QAC5D,0BAA0B,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;oBACE,kBAAkB,EAAE,KAAK;oBACzB,0BAA0B;oBAC1B,aAAa,EAAE,eAAe,EAAE,CAAC,WAAW,EAAE;oBAC9C,KAAK,EAAE;wBACL,UAAU,EAAE,iBAAiB;qBAC9B;iBACF,EACD,IAAI,EACJ,CAAC,CACF;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/server/tools/get-test-coverage-map.d.ts

@@ -0,0 +1,66 @@
+/**
+ * get-test-coverage-map.ts
+ *
+ * MCP tool: get_test_coverage_map
+ *
+ * Parses a coverage JSON report (Istanbul/NYC or V8/c8 format) and maps
+ * line-level coverage data to symbols in the indexed codebase. Returns
+ * per-file coverage metrics and per-symbol covered/uncovered status.
+ *
+ * Supported formats:
+ *   Istanbul/NYC — coverage-final.json produced by nyc, jest --coverage,
+ *                  vitest --coverage.reporter=json, c8 (json reporter).
+ *                  Keys are absolute file paths; values have statementMap,
+ *                  fnMap, branchMap, s, f, b counters.
+ *
+ *   V8           — coverage produced by Node --experimental-vm-modules or
+ *                  c8 json-summary. An array of {url, functions} objects
+ *                  where url is a file:// URI and functions carry byte-range
+ *                  hit counts.
+ *
+ * Detection strategy:
+ *   - Top-level object → Istanbul
+ *   - Top-level array  → V8
+ *   Auto-detected by default; override with the `format` parameter.
+ *
+ * Symbol coverage:
+ *   Symbols are matched to coverage functions by exact name. If no name
+ *   match is found, line-range overlap is used as a fallback.
+ *   This is a static heuristic — minified or transpiled code may reduce
+ *   accuracy. For precise coverage, ensure the coverage report was generated
+ *   from the same (or source-mapped) code that was indexed.
+ *
+ * Differs from related tools:
+ *   find_untested_symbols — name-based heuristic, no coverage file needed
+ *   get_complexity_hotspots — complexity ranking without coverage data
+ *   get_quality_metrics — per-symbol quality scoring, not coverage
+ */
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "get_test_coverage_map";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    coveragePath: z.ZodString;
+    scope: z.ZodOptional<z.ZodString>;
+    filePath: z.ZodOptional<z.ZodString>;
+    minCoverage: z.ZodOptional<z.ZodNumber>;
+    includeUncoveredLines: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+    format: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        istanbul: "istanbul";
+        v8: "v8";
+    }>>;
+};
+export declare function handler(args: {
+    repoId: string;
+    coveragePath: string;
+    scope?: string;
+    filePath?: string;
+    minCoverage?: number;
+    includeUncoveredLines?: boolean;
+    limit?: number;
+    format?: 'auto' | 'istanbul' | 'v8';
+}): Promise<CallToolResult>;
+//# sourceMappingURL=get-test-coverage-map.d.ts.map

package/dist/server/tools/get-test-coverage-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-test-coverage-map.d.ts","sourceRoot":"","sources":["../../../src/server/tools/get-test-coverage-map.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,eAAO,MAAM,IAAI,0BAA0B,CAAC;AAE5C,eAAO,MAAM,WAAW,QAY8C,CAAC;AAIvE,eAAO,MAAM,WAAW;;;;;;;;;;;;;CA0CvB,CAAC;AAudF,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;CACrC,GAAG,OAAO,CAAC,cAAc,CAAC,CAkQ1B"}