@homenshum/convex-mcp-nodebench 0.1.0

package/dist/tools/cronTools.js

@@ -0,0 +1,142 @@
+import { readFileSync, existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+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 parseCrons(content) {
+    const entries = [];
+    const lines = content.split("\n");
+    // Match crons.interval(...), crons.daily(...), crons.weekly(...), crons.monthly(...)
+    const cronPattern = /crons\.(interval|daily|weekly|monthly|cron)\s*\(/g;
+    let match;
+    while ((match = cronPattern.exec(content)) !== null) {
+        const type = match[1];
+        const startIdx = match.index;
+        const lineNumber = content.substring(0, startIdx).split("\n").length;
+        // Extract the full call (find matching paren)
+        let depth = 0;
+        let i = startIdx + match[0].length - 1; // start at the opening paren
+        const start = i;
+        for (; i < content.length; i++) {
+            if (content[i] === "(")
+                depth++;
+            else if (content[i] === ")") {
+                depth--;
+                if (depth === 0)
+                    break;
+            }
+        }
+        const callBody = content.substring(start, i + 1);
+        // Extract name (first string argument)
+        const nameMatch = callBody.match(/["'`]([^"'`]+)["'`]/);
+        const name = nameMatch ? nameMatch[1] : "unnamed";
+        // Extract schedule object
+        const scheduleMatch = callBody.match(/\{\s*([\w\s:,]+)\s*\}/);
+        const schedule = scheduleMatch ? scheduleMatch[0].trim() : "unknown";
+        // Extract handler reference
+        const handlerMatch = callBody.match(/internal\.[.\w]+/);
+        const handler = handlerMatch ? handlerMatch[0] : "unknown";
+        // Extract args
+        const argsMatches = [...callBody.matchAll(/\{\s*[\w\s:,]+\s*\}/g)];
+        const args = argsMatches.length > 2
+            ? argsMatches[argsMatches.length - 1][0].trim()
+            : "{}";
+        // Check for issues
+        const issues = [];
+        // Issue: missing internal. prefix (public function as cron handler)
+        if (handler === "unknown" && callBody.includes("api.")) {
+            issues.push("CRITICAL: Cron handler uses public api. instead of internal. — crons should only call internal functions");
+        }
+        // Issue: very frequent interval
+        if (type === "interval") {
+            const minutesMatch = schedule.match(/minutes:\s*(\d+)/);
+            if (minutesMatch && parseInt(minutesMatch[1]) < 5) {
+                issues.push(`WARNING: Interval of ${minutesMatch[1]} minutes is very frequent — consider if this rate is necessary`);
+            }
+        }
+        // Issue: duplicate name detection (done after collecting all)
+        entries.push({ name, type, schedule, handler, args, line: lineNumber, issues });
+    }
+    // Check for duplicate names
+    const nameCount = new Map();
+    for (const e of entries) {
+        nameCount.set(e.name, (nameCount.get(e.name) || 0) + 1);
+    }
+    for (const e of entries) {
+        if ((nameCount.get(e.name) || 0) > 1) {
+            e.issues.push(`CRITICAL: Duplicate cron name "${e.name}" — each cron must have a unique name`);
+        }
+    }
+    return entries;
+}
+// ── Tool Definitions ────────────────────────────────────────────────
+export const cronTools = [
+    {
+        name: "convex_check_crons",
+        description: "Validate cron job definitions in convex/crons.ts. Checks: handler references use internal (not api), no duplicate names, schedule validity, frequency analysis. Returns cron inventory with issues.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                projectDir: {
+                    type: "string",
+                    description: "Absolute path to the project root",
+                },
+            },
+            required: ["projectDir"],
+        },
+        handler: async (args) => {
+            const projectDir = resolve(args.projectDir);
+            const convexDir = findConvexDir(projectDir);
+            if (!convexDir)
+                return { error: "No convex/ directory found" };
+            const cronsPath = join(convexDir, "crons.ts");
+            if (!existsSync(cronsPath)) {
+                return {
+                    hasCrons: false,
+                    message: "No crons.ts file found — project has no scheduled jobs",
+                    quickRef: getQuickRef("convex_get_methodology"),
+                };
+            }
+            const content = readFileSync(cronsPath, "utf-8");
+            const entries = parseCrons(content);
+            const allIssues = entries.flatMap((e) => e.issues.map((i) => ({ cron: e.name, issue: i })));
+            const criticalCount = allIssues.filter((i) => i.issue.startsWith("CRITICAL")).length;
+            const warningCount = allIssues.filter((i) => i.issue.startsWith("WARNING")).length;
+            // Frequency analysis
+            const byType = {
+                interval: entries.filter((e) => e.type === "interval").length,
+                daily: entries.filter((e) => e.type === "daily").length,
+                weekly: entries.filter((e) => e.type === "weekly").length,
+                monthly: entries.filter((e) => e.type === "monthly").length,
+            };
+            return {
+                hasCrons: true,
+                totalCrons: entries.length,
+                byType,
+                issues: {
+                    total: allIssues.length,
+                    critical: criticalCount,
+                    warnings: warningCount,
+                    details: allIssues,
+                },
+                crons: entries.map((e) => ({
+                    name: e.name,
+                    type: e.type,
+                    schedule: e.schedule,
+                    handler: e.handler,
+                    line: e.line,
+                    issueCount: e.issues.length,
+                })),
+                quickRef: getQuickRef("convex_pre_deploy_gate"),
+            };
+        },
+    },
+];
+//# sourceMappingURL=cronTools.js.map

package/dist/tools/cronTools.js.map

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

package/dist/tools/deploymentTools.d.ts

@@ -0,0 +1,2 @@
+import type { McpTool } from "../types.js";
+export declare const deploymentTools: McpTool[];

package/dist/tools/deploymentTools.js

@@ -0,0 +1,222 @@
+import { existsSync, readFileSync } 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;
+}
+// ── Pre-Deploy Gate ─────────────────────────────────────────────────
+function runPreDeployChecks(projectDir) {
+    const checks = [];
+    const blockers = [];
+    // Check 1: convex/ directory exists
+    const convexDir = findConvexDir(projectDir);
+    if (!convexDir) {
+        checks.push({ name: "convex_dir_exists", passed: false, message: "No convex/ directory found" });
+        blockers.push("No convex/ directory found");
+        return { passed: false, checks, blockers };
+    }
+    checks.push({ name: "convex_dir_exists", passed: true, message: `Found at ${convexDir}` });
+    // Check 2: schema.ts exists
+    const schemaPath = join(convexDir, "schema.ts");
+    if (existsSync(schemaPath)) {
+        checks.push({ name: "schema_exists", passed: true, message: "schema.ts found" });
+        // Check 2b: schema.ts has export default
+        const schemaContent = readFileSync(schemaPath, "utf-8");
+        if (/export\s+default\s+defineSchema/.test(schemaContent)) {
+            checks.push({ name: "schema_exports_default", passed: true, message: "schema.ts exports default defineSchema" });
+        }
+        else {
+            checks.push({ name: "schema_exports_default", passed: false, message: "schema.ts missing 'export default defineSchema(...)'" });
+            blockers.push("schema.ts must export default defineSchema(...)");
+        }
+        // Check 2c: no deprecated validators
+        if (/v\.bigint\s*\(/.test(schemaContent)) {
+            checks.push({ name: "no_deprecated_validators", passed: false, message: "schema.ts uses deprecated v.bigint() - use v.int64()" });
+            blockers.push("Replace v.bigint() with v.int64() in schema.ts");
+        }
+        else {
+            checks.push({ name: "no_deprecated_validators", passed: true, message: "No deprecated validators found" });
+        }
+    }
+    else {
+        checks.push({ name: "schema_exists", passed: false, message: "No schema.ts found - Convex will use inferred schema" });
+        // Not a blocker, just a warning
+    }
+    // Check 3: auth.config.ts exists (if auth.ts exists)
+    const authPath = join(convexDir, "auth.ts");
+    const authConfigPath = join(convexDir, "auth.config.ts");
+    if (existsSync(authPath)) {
+        if (existsSync(authConfigPath)) {
+            checks.push({ name: "auth_config_exists", passed: true, message: "auth.config.ts found alongside auth.ts" });
+        }
+        else {
+            checks.push({ name: "auth_config_exists", passed: false, message: "auth.ts exists but auth.config.ts is missing" });
+            blockers.push("Create auth.config.ts to configure authentication providers");
+        }
+    }
+    // Check 4: convex.config.ts exists (for Convex components)
+    const convexConfigPath = join(convexDir, "convex.config.ts");
+    if (existsSync(convexConfigPath)) {
+        checks.push({ name: "convex_config_exists", passed: true, message: "convex.config.ts found" });
+    }
+    // Check 5: No TypeScript errors in recent audit
+    const db = getDb();
+    const latestAudit = db.prepare("SELECT * FROM audit_results WHERE project_dir = ? ORDER BY audited_at DESC LIMIT 1").get(projectDir);
+    if (latestAudit) {
+        if (latestAudit.issue_count === 0) {
+            checks.push({ name: "recent_audit_clean", passed: true, message: `Last audit (${latestAudit.audit_type}) found 0 issues` });
+        }
+        else {
+            checks.push({ name: "recent_audit_clean", passed: false, message: `Last audit (${latestAudit.audit_type}) found ${latestAudit.issue_count} issues` });
+            // Only block on critical issues
+            try {
+                const issues = JSON.parse(latestAudit.issues_json);
+                const criticals = Array.isArray(issues)
+                    ? issues.filter((i) => i.severity === "critical")
+                    : [];
+                if (criticals.length > 0) {
+                    blockers.push(`${criticals.length} critical issues from last audit need fixing`);
+                }
+            }
+            catch { /* ignore parse errors */ }
+        }
+    }
+    else {
+        checks.push({ name: "recent_audit_clean", passed: false, message: "No recent audit found. Run convex_audit_schema and convex_audit_functions first." });
+    }
+    // Check 6: _generated directory exists (project has been initialized)
+    const generatedDir = join(convexDir, "_generated");
+    if (existsSync(generatedDir)) {
+        checks.push({ name: "generated_dir_exists", passed: true, message: "_generated/ directory exists (project initialized)" });
+    }
+    else {
+        checks.push({ name: "generated_dir_exists", passed: false, message: "_generated/ not found - run 'npx convex dev' first" });
+        blockers.push("Run 'npx convex dev' to initialize the project before deploying");
+    }
+    return {
+        passed: blockers.length === 0,
+        checks,
+        blockers,
+    };
+}
+function checkEnvVars(projectDir) {
+    const result = {
+        envFilesFound: [],
+        envVarsInCode: [],
+        envVarsInEnvFile: [],
+        missingInEnvFile: [],
+        suggestions: [],
+    };
+    // Find .env files
+    const envFiles = [".env", ".env.local", ".env.example", ".env.production"];
+    for (const f of envFiles) {
+        const p = join(projectDir, f);
+        if (existsSync(p)) {
+            result.envFilesFound.push(f);
+            const content = readFileSync(p, "utf-8");
+            const vars = content.match(/^([A-Z_][A-Z0-9_]*)=/gm) || [];
+            result.envVarsInEnvFile.push(...vars.map((v) => v.replace("=", "")));
+        }
+    }
+    // Scan convex/ for process.env references
+    const convexDir = findConvexDir(projectDir);
+    if (convexDir) {
+        const files = collectTsFilesFlat(convexDir);
+        const envPattern = /process\.env\.([A-Z_][A-Z0-9_]*)/g;
+        const codeEnvVars = new Set();
+        for (const filePath of files) {
+            const content = readFileSync(filePath, "utf-8");
+            let m;
+            while ((m = envPattern.exec(content)) !== null) {
+                codeEnvVars.add(m[1]);
+            }
+        }
+        result.envVarsInCode = [...codeEnvVars];
+    }
+    // Find missing vars
+    const envFileSet = new Set(result.envVarsInEnvFile);
+    result.missingInEnvFile = result.envVarsInCode.filter((v) => !envFileSet.has(v));
+    // Suggestions
+    if (result.missingInEnvFile.length > 0) {
+        result.suggestions.push(`Set these env vars in your Convex dashboard or .env.local: ${result.missingInEnvFile.join(", ")}`);
+    }
+    if (result.envFilesFound.length === 0) {
+        result.suggestions.push("No .env files found. Create .env.local for local development.");
+    }
+    return result;
+}
+function collectTsFilesFlat(dir) {
+    const results = [];
+    if (!existsSync(dir))
+        return results;
+    const { readdirSync } = require("node:fs");
+    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(...collectTsFilesFlat(full));
+        }
+        else if (entry.isFile() && entry.name.endsWith(".ts")) {
+            results.push(full);
+        }
+    }
+    return results;
+}
+// ── Tool Definitions ────────────────────────────────────────────────
+export const deploymentTools = [
+    {
+        name: "convex_pre_deploy_gate",
+        description: "Run a comprehensive pre-deployment quality gate. Checks: convex/ directory structure, schema.ts validity, deprecated validator usage, auth configuration, recent audit results, and project initialization status. Returns pass/fail with specific blockers.",
+        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 result = runPreDeployChecks(projectDir);
+            // Store deploy check
+            const db = getDb();
+            db.prepare("INSERT INTO deploy_checks (id, project_dir, check_type, passed, findings) VALUES (?, ?, ?, ?, ?)").run(genId("deploy"), projectDir, "pre_deploy_gate", result.passed ? 1 : 0, JSON.stringify(result));
+            return {
+                ...result,
+                quickRef: getQuickRef("convex_pre_deploy_gate"),
+            };
+        },
+    },
+    {
+        name: "convex_check_env_vars",
+        description: "Check that all environment variables referenced in Convex code (process.env.*) are defined in .env files. Identifies missing vars and suggests where to set them.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                projectDir: {
+                    type: "string",
+                    description: "Absolute path to the project root",
+                },
+            },
+            required: ["projectDir"],
+        },
+        handler: async (args) => {
+            const projectDir = resolve(args.projectDir);
+            const result = checkEnvVars(projectDir);
+            return {
+                ...result,
+                quickRef: getQuickRef("convex_check_env_vars"),
+            };
+        },
+    },
+];
+//# sourceMappingURL=deploymentTools.js.map

package/dist/tools/deploymentTools.js.map

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

package/dist/tools/functionTools.d.ts

@@ -0,0 +1,2 @@
+import type { McpTool } from "../types.js";
+export declare const functionTools: McpTool[];