@homenshum/convex-mcp-nodebench 0.1.0

package/dist/tools/schemaTools.js

@@ -0,0 +1,346 @@
+import { readFileSync, existsSync, readdirSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { getDb, genId } from "../db.js";
+import { getQuickRef } from "./toolRegistry.js";
+// ── Helpers ──────────────────────────────────────────────────────────
+function findConvexDir(projectDir) {
+    const candidates = [
+        join(projectDir, "convex"),
+        join(projectDir, "src", "convex"),
+    ];
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    return null;
+}
+function readSchemaFile(convexDir) {
+    const schemaPath = join(convexDir, "schema.ts");
+    if (!existsSync(schemaPath))
+        return null;
+    return readFileSync(schemaPath, "utf-8");
+}
+function collectTsFiles(dir, ext = ".ts") {
+    const results = [];
+    if (!existsSync(dir))
+        return results;
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const full = join(dir, entry.name);
+        if (entry.isDirectory() && entry.name !== "node_modules" && entry.name !== "_generated") {
+            results.push(...collectTsFiles(full, ext));
+        }
+        else if (entry.isFile() && entry.name.endsWith(ext)) {
+            results.push(full);
+        }
+    }
+    return results;
+}
+// ── Schema Analysis Engine ──────────────────────────────────────────
+function analyzeSchema(schemaContent, filePath) {
+    const issues = [];
+    const lines = schemaContent.split("\n");
+    // Check: v.bigint() usage (deprecated)
+    lines.forEach((line, i) => {
+        if (/v\.bigint\s*\(/.test(line)) {
+            issues.push({
+                severity: "critical",
+                location: `${filePath}:${i + 1}`,
+                message: "v.bigint() is deprecated. Use v.int64() instead.",
+                fix: "Replace v.bigint() with v.int64()",
+                gotchaKey: "validator_bigint_deprecated",
+            });
+        }
+    });
+    // Check: v.map() or v.set() usage (unsupported)
+    lines.forEach((line, i) => {
+        if (/v\.(map|set)\s*\(/.test(line)) {
+            const match = line.match(/v\.(map|set)/);
+            issues.push({
+                severity: "critical",
+                location: `${filePath}:${i + 1}`,
+                message: `v.${match?.[1]}() is not supported. Use v.record(keys, values) instead.`,
+                fix: "Replace with v.record(keyValidator, valueValidator)",
+                gotchaKey: "no_map_set_validators",
+            });
+        }
+    });
+    // Check: fields starting with $ or _
+    const fieldNamePattern = /["'](\$|_)[\w]+["']\s*:/g;
+    lines.forEach((line, i) => {
+        let match;
+        while ((match = fieldNamePattern.exec(line)) !== null) {
+            // Ignore system fields in comments
+            if (line.trim().startsWith("//") || line.trim().startsWith("*"))
+                continue;
+            issues.push({
+                severity: "critical",
+                location: `${filePath}:${i + 1}`,
+                message: `Field name starts with '${match[1]}' which is reserved for system use.`,
+                fix: "Rename the field to not start with '$' or '_'",
+                gotchaKey: "field_no_dollar_underscore",
+            });
+        }
+    });
+    // Check: defineTable without any indexes
+    const tablePattern = /defineTable\s*\(/g;
+    const indexPattern = /\.index\s*\(/g;
+    const tableCount = (schemaContent.match(tablePattern) || []).length;
+    const indexCount = (schemaContent.match(indexPattern) || []).length;
+    if (tableCount > 0 && indexCount === 0) {
+        issues.push({
+            severity: "warning",
+            location: filePath,
+            message: `Schema defines ${tableCount} table(s) but has no indexes. Most apps need indexes for efficient queries.`,
+            fix: "Add .index() calls to defineTable for fields you query by",
+            gotchaKey: "index_field_order",
+        });
+    }
+    // Check: index names don't include field names
+    const indexDefPattern = /\.index\s*\(\s*["']([^"']+)["']\s*,\s*\[([^\]]+)\]/g;
+    let idxMatch;
+    while ((idxMatch = indexDefPattern.exec(schemaContent)) !== null) {
+        const indexName = idxMatch[1];
+        const fieldsRaw = idxMatch[2];
+        const fields = fieldsRaw.match(/["']([^"']+)["']/g)?.map((f) => f.replace(/["']/g, "")) || [];
+        const allFieldsInName = fields.every((f) => indexName.toLowerCase().includes(f.toLowerCase()));
+        if (!allFieldsInName && fields.length > 0) {
+            issues.push({
+                severity: "info",
+                location: filePath,
+                message: `Index "${indexName}" does not include all field names (${fields.join(", ")}). Convention: use "by_${fields.join("_and_")}".`,
+                fix: `Rename index to "by_${fields.join("_and_")}"`,
+                gotchaKey: "index_name_include_fields",
+            });
+        }
+    }
+    // Check: _creationTime or _id in schema definition (system fields)
+    lines.forEach((line, i) => {
+        if (line.trim().startsWith("//") || line.trim().startsWith("*"))
+            return;
+        if (/["']_creationTime["']|["']_id["']/.test(line) && /v\./.test(line)) {
+            issues.push({
+                severity: "warning",
+                location: `${filePath}:${i + 1}`,
+                message: "System fields (_id, _creationTime) are auto-added. Don't include them in schema.",
+                fix: "Remove the system field from your schema definition",
+                gotchaKey: "system_fields_auto",
+            });
+        }
+    });
+    return issues;
+}
+function analyzeValidatorCoverage(convexDir) {
+    const files = collectTsFiles(convexDir);
+    const result = {
+        totalFunctions: 0,
+        withArgs: 0,
+        withReturns: 0,
+        missingArgs: [],
+        missingReturns: [],
+        usingOldSyntax: [],
+    };
+    const funcTypes = ["query", "internalQuery", "mutation", "internalMutation", "action", "internalAction"];
+    const funcPattern = new RegExp(`export\\s+(?:const|default)\\s+(\\w+)?\\s*=\\s*(${funcTypes.join("|")})\\s*\\(`, "g");
+    for (const filePath of files) {
+        const content = readFileSync(filePath, "utf-8");
+        const relativePath = filePath.replace(convexDir, "").replace(/^[\\/]/, "");
+        let match;
+        while ((match = funcPattern.exec(content)) !== null) {
+            const funcName = match[1] || "default";
+            const location = `${relativePath}:${funcName}`;
+            result.totalFunctions++;
+            // Find the function body (rough heuristic - look for args: and returns: nearby)
+            const startIdx = match.index;
+            const chunk = content.slice(startIdx, startIdx + 500);
+            if (/args\s*:\s*\{/.test(chunk) || /args\s*:\s*v\./.test(chunk)) {
+                result.withArgs++;
+            }
+            else {
+                result.missingArgs.push(location);
+            }
+            if (/returns\s*:\s*v\./.test(chunk)) {
+                result.withReturns++;
+            }
+            else {
+                result.missingReturns.push(location);
+            }
+            // Check for old syntax (handler as second argument, not in object)
+            if (/\(\s*async\s*\(ctx/.test(chunk) && !/handler\s*:/.test(chunk)) {
+                result.usingOldSyntax.push(location);
+            }
+        }
+    }
+    return result;
+}
+function suggestIndexes(convexDir) {
+    const suggestions = [];
+    const files = collectTsFiles(convexDir);
+    // Track query patterns: db.query("table").withIndex("name", ...) or .filter(q => q.eq(q.field("x"), ...))
+    const queryPattern = /\.query\s*\(\s*["'](\w+)["']\s*\)/g;
+    const filterFieldPattern = /q\.field\s*\(\s*["'](\w+)["']\s*\)/g;
+    const withIndexPattern = /\.withIndex\s*\(\s*["'](\w+)["']/g;
+    const tableQueryFields = new Map();
+    const existingIndexes = new Set();
+    for (const filePath of files) {
+        const content = readFileSync(filePath, "utf-8");
+        // Collect existing indexes
+        let idxMatch;
+        while ((idxMatch = withIndexPattern.exec(content)) !== null) {
+            existingIndexes.add(idxMatch[1]);
+        }
+        // Collect query + filter patterns
+        let qMatch;
+        while ((qMatch = queryPattern.exec(content)) !== null) {
+            const tableName = qMatch[1];
+            // Look for filter fields nearby
+            const nearbyContent = content.slice(qMatch.index, qMatch.index + 300);
+            let fMatch;
+            while ((fMatch = filterFieldPattern.exec(nearbyContent)) !== null) {
+                const field = fMatch[1];
+                if (field === "_id" || field === "_creationTime")
+                    continue;
+                if (!tableQueryFields.has(tableName)) {
+                    tableQueryFields.set(tableName, new Set());
+                }
+                tableQueryFields.get(tableName).add(field);
+            }
+        }
+    }
+    // Generate suggestions for frequently queried fields
+    for (const [table, fields] of tableQueryFields) {
+        for (const field of fields) {
+            const indexName = `by_${field}`;
+            if (!existingIndexes.has(indexName)) {
+                suggestions.push({
+                    table,
+                    fields: [field],
+                    suggestedName: indexName,
+                    reason: `Queries filter on "${table}.${field}" but no index exists for it`,
+                });
+            }
+        }
+    }
+    return suggestions;
+}
+// ── Tool Definitions ────────────────────────────────────────────────
+export const schemaTools = [
+    {
+        name: "convex_audit_schema",
+        description: "Analyze a Convex project's schema.ts for anti-patterns, deprecated validators, reserved field names, missing indexes, and naming convention violations. Scans the convex/ directory and returns categorized issues with fix suggestions.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                projectDir: {
+                    type: "string",
+                    description: "Absolute path to the project root containing a convex/ directory",
+                },
+            },
+            required: ["projectDir"],
+        },
+        handler: async (args) => {
+            const projectDir = resolve(args.projectDir);
+            const convexDir = findConvexDir(projectDir);
+            if (!convexDir) {
+                return {
+                    error: "No convex/ directory found",
+                    hint: "Ensure projectDir points to a directory containing a convex/ folder",
+                };
+            }
+            const schemaContent = readSchemaFile(convexDir);
+            if (!schemaContent) {
+                return {
+                    error: "No convex/schema.ts found",
+                    hint: "Create a schema.ts file in your convex/ directory",
+                    quickRef: getQuickRef("convex_audit_schema"),
+                };
+            }
+            const schemaPath = join(convexDir, "schema.ts");
+            const issues = analyzeSchema(schemaContent, schemaPath);
+            // Store audit result
+            const db = getDb();
+            db.prepare("INSERT INTO audit_results (id, project_dir, audit_type, file_path, issues_json, issue_count) VALUES (?, ?, ?, ?, ?, ?)").run(genId("audit"), projectDir, "schema", schemaPath, JSON.stringify(issues), issues.length);
+            const critical = issues.filter((i) => i.severity === "critical");
+            const warnings = issues.filter((i) => i.severity === "warning");
+            const info = issues.filter((i) => i.severity === "info");
+            return {
+                summary: {
+                    totalIssues: issues.length,
+                    critical: critical.length,
+                    warnings: warnings.length,
+                    info: info.length,
+                    schemaFile: schemaPath,
+                },
+                issues,
+                quickRef: getQuickRef("convex_audit_schema"),
+            };
+        },
+    },
+    {
+        name: "convex_suggest_indexes",
+        description: "Analyze query patterns across all Convex functions and suggest missing indexes. Scans for .query().filter() patterns and compares against defined indexes in schema.ts.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                projectDir: {
+                    type: "string",
+                    description: "Absolute path to the project root containing a convex/ directory",
+                },
+            },
+            required: ["projectDir"],
+        },
+        handler: async (args) => {
+            const projectDir = resolve(args.projectDir);
+            const convexDir = findConvexDir(projectDir);
+            if (!convexDir) {
+                return { error: "No convex/ directory found" };
+            }
+            const suggestions = suggestIndexes(convexDir);
+            return {
+                totalSuggestions: suggestions.length,
+                suggestions,
+                quickRef: getQuickRef("convex_suggest_indexes"),
+            };
+        },
+    },
+    {
+        name: "convex_check_validator_coverage",
+        description: "Check that all exported Convex functions (query, mutation, action, and their internal variants) have both args and returns validators. Reports functions missing validators and those using deprecated old syntax.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                projectDir: {
+                    type: "string",
+                    description: "Absolute path to the project root containing a convex/ directory",
+                },
+            },
+            required: ["projectDir"],
+        },
+        handler: async (args) => {
+            const projectDir = resolve(args.projectDir);
+            const convexDir = findConvexDir(projectDir);
+            if (!convexDir) {
+                return { error: "No convex/ directory found" };
+            }
+            const result = analyzeValidatorCoverage(convexDir);
+            const passed = result.missingArgs.length === 0 && result.missingReturns.length === 0;
+            // Store audit result
+            const db = getDb();
+            db.prepare("INSERT INTO audit_results (id, project_dir, audit_type, issues_json, issue_count) VALUES (?, ?, ?, ?, ?)").run(genId("audit"), projectDir, "validator_coverage", JSON.stringify(result), result.missingArgs.length + result.missingReturns.length);
+            return {
+                passed,
+                summary: {
+                    totalFunctions: result.totalFunctions,
+                    argsValidatorCoverage: `${result.withArgs}/${result.totalFunctions}`,
+                    returnsValidatorCoverage: `${result.withReturns}/${result.totalFunctions}`,
+                    oldSyntaxCount: result.usingOldSyntax.length,
+                },
+                missingArgs: result.missingArgs.length > 0 ? result.missingArgs : undefined,
+                missingReturns: result.missingReturns.length > 0 ? result.missingReturns : undefined,
+                usingOldSyntax: result.usingOldSyntax.length > 0 ? result.usingOldSyntax : undefined,
+                quickRef: getQuickRef("convex_check_validator_coverage"),
+            };
+        },
+    },
+];
+//# sourceMappingURL=schemaTools.js.map

package/dist/tools/schemaTools.js.map

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

package/dist/tools/toolRegistry.d.ts

@@ -0,0 +1,5 @@
+import type { ConvexQuickRef, ToolRegistryEntry } from "../types.js";
+export declare const REGISTRY: ToolRegistryEntry[];
+export declare function getQuickRef(toolName: string): ConvexQuickRef | null;
+export declare function getToolsByCategory(category: string): ToolRegistryEntry[];
+export declare function findTools(query: string): ToolRegistryEntry[];