purecontext-mcp 1.1.8 → 1.2.0

package/dist/server/tools/search-by-complexity.js

@@ -0,0 +1,268 @@
+/**
+ * search-by-complexity.ts
+ *
+ * MCP tool: search_by_complexity
+ *
+ * Find all symbols whose complexity metrics match a set of min/max filters.
+ * Covers six dimensions stored at index time:
+ *   cyclomatic_complexity, cognitive_complexity, line_count,
+ *   nesting_depth, param_count, return_count
+ *
+ * All filters are optional and combined with AND. Omitting a filter means
+ * "no constraint on that dimension". The tool returns only symbols that have
+ * metrics (logic-carrying kinds: function, method, class, component, etc.).
+ *
+ * Designed for targeted queries like:
+ *   "show me every function with ≥8 cyclomatic complexity"
+ *   "find all methods with exactly 0–2 parameters"
+ *   "list functions that are between 20 and 50 lines"
+ *
+ * Use get_quality_metrics when you want a ranked worst-offenders list with a
+ * composite score. Use search_by_complexity when you have a specific threshold
+ * or range in mind for one or more individual dimensions.
+ */
+import { z } from 'zod';
+import { openDatabase } from '../../core/db/schema.js';
+import { buildMeta } from './_meta.js';
+export const name = 'search_by_complexity';
+export const description = 'Find symbols matching specific complexity criteria. ' +
+    'Filter by any combination of cyclomatic complexity, cognitive complexity, ' +
+    'line count, nesting depth, parameter count, and return count — each with ' +
+    'optional min and/or max bounds. Only symbols with computed metrics are returned ' +
+    '(functions, methods, classes, components, etc.).' +
+    '\n\nExample use cases:' +
+    '\n  minCyclomaticComplexity: 8              — dangerously complex functions' +
+    '\n  minParamCount: 5                        — functions with too many arguments' +
+    '\n  minLineCount: 100                       — long functions to split' +
+    '\n  minNestingDepth: 4                      — deeply nested, hard-to-read code' +
+    '\n  maxCyclomaticComplexity: 2, maxLineCount: 15  — simple utility functions' +
+    '\n  minReturnCount: 4                       — functions with many exit points';
+export const inputSchema = {
+    repoId: z.string().describe('Repository ID returned by index_folder or list_repos'),
+    // Cyclomatic complexity bounds
+    minCyclomaticComplexity: z
+        .number().int().min(1).optional()
+        .describe('Only return symbols with cyclomatic complexity ≥ this value'),
+    maxCyclomaticComplexity: z
+        .number().int().min(1).optional()
+        .describe('Only return symbols with cyclomatic complexity ≤ this value'),
+    // Cognitive complexity bounds
+    minCognitiveComplexity: z
+        .number().int().min(1).optional()
+        .describe('Only return symbols with cognitive complexity ≥ this value'),
+    maxCognitiveComplexity: z
+        .number().int().min(1).optional()
+        .describe('Only return symbols with cognitive complexity ≤ this value'),
+    // Line count bounds
+    minLineCount: z
+        .number().int().min(1).optional()
+        .describe('Only return symbols with line count ≥ this value'),
+    maxLineCount: z
+        .number().int().min(1).optional()
+        .describe('Only return symbols with line count ≤ this value'),
+    // Nesting depth bounds
+    minNestingDepth: z
+        .number().int().min(1).optional()
+        .describe('Only return symbols with max nesting depth ≥ this value'),
+    maxNestingDepth: z
+        .number().int().min(1).optional()
+        .describe('Only return symbols with max nesting depth ≤ this value'),
+    // Param count bounds
+    minParamCount: z
+        .number().int().min(0).optional()
+        .describe('Only return symbols with parameter count ≥ this value'),
+    maxParamCount: z
+        .number().int().min(0).optional()
+        .describe('Only return symbols with parameter count ≤ this value'),
+    // Return count bounds
+    minReturnCount: z
+        .number().int().min(0).optional()
+        .describe('Only return symbols with return statement count ≥ this value'),
+    maxReturnCount: z
+        .number().int().min(0).optional()
+        .describe('Only return symbols with return statement count ≤ this value'),
+    // Sort controls
+    sortBy: z
+        .enum(['complexity', 'cognitive', 'size', 'nesting', 'params', 'returns'])
+        .optional()
+        .describe('Sort dimension: "complexity" (cyclomatic, default), "cognitive", ' +
+        '"size" (line count), "nesting", "params", "returns"'),
+    sortOrder: z
+        .enum(['asc', 'desc'])
+        .optional()
+        .describe('Sort direction: "desc" (default, worst first) or "asc" (best first)'),
+    // Filters
+    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'),
+    filePath: z
+        .string()
+        .optional()
+        .describe('Restrict search to a specific file path or directory prefix'),
+    limit: z
+        .number().int().positive().optional()
+        .describe('Maximum number of results to return (default 50)'),
+};
+// ─── Sort column map ──────────────────────────────────────────────────────────
+const SORT_COL = {
+    complexity: 'cyclomatic_complexity',
+    cognitive: 'cognitive_complexity',
+    size: 'line_count',
+    nesting: 'nesting_depth',
+    params: 'param_count',
+    returns: 'return_count',
+};
+// ─── Handler ──────────────────────────────────────────────────────────────────
+export async function handler(args) {
+    const t0 = Date.now();
+    const { repoId, sortBy = 'complexity', sortOrder = 'desc', limit = 50, } = args;
+    const db = openDatabase(repoId);
+    try {
+        // ── Build query ────────────────────────────────────────────────────────────
+        const conditions = ['repo_id = @repoId', 'line_count IS NOT NULL'];
+        const params = { repoId };
+        if (args.minCyclomaticComplexity !== undefined) {
+            conditions.push('COALESCE(cyclomatic_complexity, 1) >= @minCC');
+            params['minCC'] = args.minCyclomaticComplexity;
+        }
+        if (args.maxCyclomaticComplexity !== undefined) {
+            conditions.push('COALESCE(cyclomatic_complexity, 1) <= @maxCC');
+            params['maxCC'] = args.maxCyclomaticComplexity;
+        }
+        if (args.minCognitiveComplexity !== undefined) {
+            conditions.push('COALESCE(cognitive_complexity, 0) >= @minCog');
+            params['minCog'] = args.minCognitiveComplexity;
+        }
+        if (args.maxCognitiveComplexity !== undefined) {
+            conditions.push('COALESCE(cognitive_complexity, 0) <= @maxCog');
+            params['maxCog'] = args.maxCognitiveComplexity;
+        }
+        if (args.minLineCount !== undefined) {
+            conditions.push('COALESCE(line_count, 0) >= @minLC');
+            params['minLC'] = args.minLineCount;
+        }
+        if (args.maxLineCount !== undefined) {
+            conditions.push('COALESCE(line_count, 0) <= @maxLC');
+            params['maxLC'] = args.maxLineCount;
+        }
+        if (args.minNestingDepth !== undefined) {
+            conditions.push('COALESCE(nesting_depth, 0) >= @minND');
+            params['minND'] = args.minNestingDepth;
+        }
+        if (args.maxNestingDepth !== undefined) {
+            conditions.push('COALESCE(nesting_depth, 0) <= @maxND');
+            params['maxND'] = args.maxNestingDepth;
+        }
+        if (args.minParamCount !== undefined) {
+            conditions.push('COALESCE(param_count, 0) >= @minPC');
+            params['minPC'] = args.minParamCount;
+        }
+        if (args.maxParamCount !== undefined) {
+            conditions.push('COALESCE(param_count, 0) <= @maxPC');
+            params['maxPC'] = args.maxParamCount;
+        }
+        if (args.minReturnCount !== undefined) {
+            conditions.push('COALESCE(return_count, 0) >= @minRC');
+            params['minRC'] = args.minReturnCount;
+        }
+        if (args.maxReturnCount !== undefined) {
+            conditions.push('COALESCE(return_count, 0) <= @maxRC');
+            params['maxRC'] = args.maxReturnCount;
+        }
+        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 orderCol = SORT_COL[sortBy] ?? 'cyclomatic_complexity';
+        const order = sortOrder === 'asc' ? 'ASC' : 'DESC';
+        const sql = `
+      SELECT id, name, kind, file_path, start_byte, signature, summary,
+             COALESCE(line_count, 0)            AS line_count,
+             COALESCE(cyclomatic_complexity, 1)  AS cyclomatic_complexity,
+             COALESCE(cognitive_complexity, 0)   AS cognitive_complexity,
+             COALESCE(param_count, 0)            AS param_count,
+             COALESCE(return_count, 0)           AS return_count,
+             COALESCE(nesting_depth, 0)          AS nesting_depth
+      FROM symbols
+      WHERE ${conditions.join(' AND ')}
+      ORDER BY ${orderCol} ${order}, file_path ASC, start_byte ASC
+      LIMIT @limit
+    `;
+        const rows = db.prepare(sql).all(params);
+        // ── 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(); // symbolId → startLine
+        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) {
+                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 output ───────────────────────────────────────────────────────────
+        const symbols = 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,
+            metrics: {
+                cyclomaticComplexity: row.cyclomatic_complexity,
+                cognitiveComplexity: row.cognitive_complexity,
+                lineCount: row.line_count,
+                nestingDepth: row.nesting_depth,
+                paramCount: row.param_count,
+                returnCount: row.return_count,
+            },
+        }));
+        const responseBytes = symbols.reduce((sum, s) => sum + s.signature.length + s.summary.length + s.filePath.length + 100, 0);
+        const tokenEstimate = Math.ceil(responseBytes / 4);
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        symbols,
+                        totalFound: symbols.length,
+                        sortedBy: sortBy,
+                        sortOrder,
+                        _tokenEstimate: tokenEstimate,
+                        _meta: buildMeta({ timingMs: Date.now() - t0 }),
+                    }, null, 2),
+                }],
+        };
+    }
+    finally {
+        db.close();
+    }
+}
+//# sourceMappingURL=search-by-complexity.js.map

package/dist/server/tools/search-by-complexity.js.map

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

package/dist/server/tools/search-by-decorator.d.ts

@@ -0,0 +1,48 @@
+/**
+ * search-by-decorator.ts
+ *
+ * MCP tool: search_by_decorator
+ *
+ * Find all symbols (classes, methods, functions, properties) annotated with
+ * a specific decorator. Re-parses stored file content via tree-sitter to
+ * locate `decorator` AST nodes, then resolves each back to its parent symbol
+ * in the index.
+ *
+ * Three match modes:
+ *  - exact    (default) — decorator name exactly matches the query (case-sensitive)
+ *  - contains           — decorator name contains the query
+ *  - prefix             — decorator name starts with the query
+ *
+ * Parameter decorators (on function parameters) are excluded — they do not
+ * correspond to indexed symbols.
+ *
+ * Only files backed by a WASM grammar are searched. Regex-only handlers
+ * (Perl, Terraform, Protobuf, GraphQL, etc.) are silently skipped.
+ */
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const name = "search_by_decorator";
+export declare const description: string;
+export declare const inputSchema: {
+    repoId: z.ZodString;
+    decoratorName: z.ZodString;
+    matchMode: z.ZodOptional<z.ZodEnum<{
+        prefix: "prefix";
+        contains: "contains";
+        exact: "exact";
+    }>>;
+    language: z.ZodOptional<z.ZodString>;
+    filePath: z.ZodOptional<z.ZodString>;
+    includeDecoratorText: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodOptional<z.ZodNumber>;
+};
+export declare function handler(args: {
+    repoId: string;
+    decoratorName: string;
+    matchMode?: 'exact' | 'contains' | 'prefix';
+    language?: string;
+    filePath?: string;
+    includeDecoratorText?: boolean;
+    limit?: number;
+}): Promise<CallToolResult>;
+//# sourceMappingURL=search-by-decorator.d.ts.map

package/dist/server/tools/search-by-decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-by-decorator.d.ts","sourceRoot":"","sources":["../../../src/server/tools/search-by-decorator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,eAAO,MAAM,IAAI,wBAAwB,CAAC;AAE1C,eAAO,MAAM,WAAW,QAagE,CAAC;AAEzF,eAAO,MAAM,WAAW;;;;;;;;;;;;CAyCvB,CAAC;AAqUF,wBAAsB,OAAO,CAAC,IAAI,EAAE;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyN1B"}