@homenshum/convex-mcp-nodebench 0.1.0

package/dist/tools/learningTools.js

@@ -0,0 +1,155 @@
+import { getDb } from "../db.js";
+import { getQuickRef } from "./toolRegistry.js";
+export const learningTools = [
+    {
+        name: "convex_record_gotcha",
+        description: "Record a Convex-specific gotcha, edge case, or pattern for future reference. Stored persistently and searchable via full-text search. Categories: validator, schema, function, deployment, auth, performance, general.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                key: {
+                    type: "string",
+                    description: "Short unique identifier (e.g., 'v-optional-default-undefined', 'cron-overlap-race')",
+                },
+                content: {
+                    type: "string",
+                    description: "Detailed description of the gotcha: what happened, why, and how to avoid it",
+                },
+                category: {
+                    type: "string",
+                    enum: ["validator", "schema", "function", "deployment", "auth", "performance", "general"],
+                    description: "Category of the gotcha",
+                },
+                severity: {
+                    type: "string",
+                    enum: ["critical", "warning", "info"],
+                    description: "How severe this gotcha is",
+                },
+                tags: {
+                    type: "string",
+                    description: "Comma-separated tags for searchability",
+                },
+            },
+            required: ["key", "content", "category"],
+        },
+        handler: async (args) => {
+            const db = getDb();
+            // Upsert: update if exists, insert if not
+            const existing = db.prepare("SELECT id FROM convex_gotchas WHERE key = ?").get(args.key);
+            if (existing) {
+                db.prepare("UPDATE convex_gotchas SET content = ?, category = ?, severity = ?, tags = ?, source = 'user', updated_at = datetime('now') WHERE key = ?").run(args.content, args.category, args.severity || "warning", args.tags || "", args.key);
+                return {
+                    action: "updated",
+                    key: args.key,
+                    quickRef: getQuickRef("convex_record_gotcha"),
+                };
+            }
+            db.prepare("INSERT INTO convex_gotchas (key, content, category, severity, tags, source) VALUES (?, ?, ?, ?, ?, 'user')").run(args.key, args.content, args.category, args.severity || "warning", args.tags || "");
+            return {
+                action: "created",
+                key: args.key,
+                quickRef: getQuickRef("convex_record_gotcha"),
+            };
+        },
+    },
+    {
+        name: "convex_search_gotchas",
+        description: "Search the persistent Convex gotcha database using full-text search. Returns relevant gotchas, edge cases, and patterns. Always search before starting a new Convex implementation to avoid known pitfalls.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "What you're about to implement or the issue you're hitting (e.g., 'array validator', 'index query order', 'action runtime')",
+                },
+                category: {
+                    type: "string",
+                    enum: ["validator", "schema", "function", "deployment", "auth", "performance", "general"],
+                    description: "Optional: filter by category",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max results (default 10)",
+                },
+            },
+            required: ["query"],
+        },
+        handler: async (args) => {
+            const db = getDb();
+            const limit = args.limit || 10;
+            let results;
+            try {
+                // FTS5 search
+                let sql = `
+          SELECT g.*, rank
+          FROM convex_gotchas g
+          JOIN convex_gotchas_fts fts ON g.id = fts.rowid
+          WHERE convex_gotchas_fts MATCH ?
+        `;
+                const params = [args.query];
+                if (args.category) {
+                    sql += " AND g.category = ?";
+                    params.push(args.category);
+                }
+                sql += " ORDER BY rank LIMIT ?";
+                params.push(limit);
+                results = db.prepare(sql).all(...params);
+            }
+            catch {
+                // Fallback to LIKE search with JS-side BM25 scoring
+                let sql = "SELECT * FROM convex_gotchas WHERE (key LIKE ? OR content LIKE ? OR tags LIKE ?)";
+                const likeTerm = `%${args.query}%`;
+                const params = [likeTerm, likeTerm, likeTerm];
+                if (args.category) {
+                    sql += " AND category = ?";
+                    params.push(args.category);
+                }
+                sql += " LIMIT 100"; // Fetch more, then rank and trim
+                const raw = db.prepare(sql).all(...params);
+                // BM25-style scoring on LIKE results (field-weighted)
+                const queryTerms = args.query.toLowerCase().match(/[a-z_]+/g) ?? [];
+                if (queryTerms.length > 0 && raw.length > 1) {
+                    const avgLen = raw.reduce((s, r) => s + (r.content?.length ?? 0), 0) / raw.length || 1;
+                    const scored = raw.map((r) => {
+                        const keyText = (r.key ?? "").toLowerCase();
+                        const contentText = (r.content ?? "").toLowerCase();
+                        const tagsText = (r.tags ?? "").toLowerCase();
+                        const dl = contentText.length;
+                        let score = 0;
+                        for (const qt of queryTerms) {
+                            // Field-weighted term frequency: key 3x, tags 2x, content 1x
+                            const keyHits = (keyText.match(new RegExp(qt, "g")) ?? []).length * 3;
+                            const tagHits = (tagsText.match(new RegExp(qt, "g")) ?? []).length * 2;
+                            const contentHits = (contentText.match(new RegExp(qt, "g")) ?? []).length;
+                            const tf = keyHits + tagHits + contentHits;
+                            if (tf === 0)
+                                continue;
+                            // BM25 saturation + length normalization
+                            const k1 = 1.2, b = 0.75;
+                            score += (tf * (k1 + 1)) / (tf + k1 * (1 - b + b * (dl / avgLen)));
+                        }
+                        return { ...r, _score: score };
+                    });
+                    scored.sort((a, b) => b._score - a._score);
+                    results = scored.slice(0, limit);
+                }
+                else {
+                    results = raw.slice(0, limit);
+                }
+            }
+            return {
+                totalResults: results.length,
+                gotchas: results.map((r) => ({
+                    key: r.key,
+                    content: r.content,
+                    category: r.category,
+                    severity: r.severity,
+                    tags: r.tags,
+                    source: r.source,
+                })),
+                quickRef: getQuickRef("convex_search_gotchas"),
+            };
+        },
+    },
+];
+//# sourceMappingURL=learningTools.js.map

package/dist/tools/learningTools.js.map

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

package/dist/tools/methodologyTools.d.ts

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

package/dist/tools/methodologyTools.js

@@ -0,0 +1,163 @@
+import { findTools, REGISTRY } from "./toolRegistry.js";
+import { getQuickRef } from "./toolRegistry.js";
+// ── Methodology Content ─────────────────────────────────────────────
+const METHODOLOGY_CONTENT = {
+    overview: {
+        title: "convex-mcp-nodebench Methodology Overview",
+        description: "All available methodologies for Convex development with self-instruct guidance.",
+        steps: [
+            "1. convex_schema_audit — Audit schema.ts for anti-patterns before any schema change",
+            "2. convex_function_compliance — Ensure all functions have validators and correct registration",
+            "3. convex_deploy_verification — Pre-deploy quality gate with comprehensive checks",
+            "4. convex_knowledge_management — Record and search gotchas to prevent repeat mistakes",
+            "5. convex_index_optimization — Analyze query patterns and suggest optimal indexes",
+        ],
+        tools: ["convex_discover_tools", "convex_get_methodology"],
+    },
+    convex_schema_audit: {
+        title: "Schema Audit Methodology",
+        description: "Systematically verify your Convex schema.ts for correctness, performance, and best practices.",
+        steps: [
+            "1. Run convex_audit_schema to scan schema.ts for anti-patterns (deprecated validators, reserved field names, missing indexes)",
+            "2. Review each issue by severity: fix CRITICAL first, then WARNING, then INFO",
+            "3. Run convex_suggest_indexes to find query patterns that need index support",
+            "4. Add suggested indexes to schema.ts with proper naming (by_field1_and_field2)",
+            "5. Run convex_check_validator_coverage to ensure all functions have arg + return validators",
+            "6. Run convex_audit_schema again to verify all issues are resolved",
+            "7. Run convex_pre_deploy_gate before deploying",
+        ],
+        tools: ["convex_audit_schema", "convex_suggest_indexes", "convex_check_validator_coverage", "convex_pre_deploy_gate"],
+    },
+    convex_function_compliance: {
+        title: "Function Compliance Methodology",
+        description: "Ensure all Convex functions follow best practices for registration, validators, and access control.",
+        steps: [
+            "1. Run convex_audit_functions to scan all exported functions for issues",
+            "2. Fix critical issues: add missing args/returns validators, switch to new syntax",
+            "3. Review public vs internal: sensitive functions (admin, delete, purge, migrate) should be internal",
+            "4. Run convex_check_function_refs to validate all api.x.y and internal.x.y references",
+            "5. Fix any direct function passing (use api.x.y references instead)",
+            "6. Check for action-from-action anti-patterns (extract to helper functions)",
+            "7. Re-run convex_audit_functions to verify compliance",
+        ],
+        tools: ["convex_audit_functions", "convex_check_function_refs", "convex_check_validator_coverage"],
+    },
+    convex_deploy_verification: {
+        title: "Deploy Verification Methodology",
+        description: "Comprehensive pre-deployment checklist ensuring your Convex project is ready to ship.",
+        steps: [
+            "1. Run convex_audit_schema — fix all critical schema issues",
+            "2. Run convex_audit_functions — fix all critical function issues",
+            "3. Run convex_check_env_vars — ensure all required env vars are set",
+            "4. Run convex_pre_deploy_gate — this runs the full gate check",
+            "5. Fix all blockers reported by the gate",
+            "6. Run npx convex deploy only after the gate passes",
+            "7. Record any new gotchas discovered during deploy with convex_record_gotcha",
+        ],
+        tools: ["convex_audit_schema", "convex_audit_functions", "convex_check_env_vars", "convex_pre_deploy_gate", "convex_record_gotcha"],
+    },
+    convex_knowledge_management: {
+        title: "Knowledge Management Methodology",
+        description: "Build and leverage a persistent knowledge base of Convex gotchas, edge cases, and patterns.",
+        steps: [
+            "1. BEFORE implementing: run convex_search_gotchas with your task description",
+            "2. Apply any relevant gotchas to your implementation plan",
+            "3. During development: if you hit a non-obvious issue, record it with convex_record_gotcha",
+            "4. After fixing bugs: record the root cause and fix as a gotcha",
+            "5. Categories: validator, schema, function, deployment, auth, performance, general",
+            "6. Use severity levels: critical (will break), warning (may cause issues), info (best practice)",
+        ],
+        tools: ["convex_search_gotchas", "convex_record_gotcha"],
+    },
+    convex_index_optimization: {
+        title: "Index Optimization Methodology",
+        description: "Optimize query performance by analyzing access patterns and adding appropriate indexes.",
+        steps: [
+            "1. Run convex_suggest_indexes to scan all query patterns",
+            "2. Review each suggestion: does the query pattern warrant an index?",
+            "3. For composite queries, ensure index field order matches query filter order",
+            "4. Add indexes to schema.ts following naming convention: by_field1_and_field2",
+            "5. Remember: index fields must be queried in the SAME ORDER they are defined",
+            "6. If you need different query orders, create separate indexes",
+            "7. Run convex_audit_schema to verify index naming conventions",
+        ],
+        tools: ["convex_suggest_indexes", "convex_audit_schema"],
+    },
+};
+// ── Tool Definitions ────────────────────────────────────────────────
+export const methodologyTools = [
+    {
+        name: "convex_get_methodology",
+        description: "Get step-by-step guidance for Convex development workflows. Topics: overview, convex_schema_audit, convex_function_compliance, convex_deploy_verification, convex_knowledge_management, convex_index_optimization. Call with 'overview' to see all available methodologies.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                topic: {
+                    type: "string",
+                    enum: [
+                        "overview",
+                        "convex_schema_audit",
+                        "convex_function_compliance",
+                        "convex_deploy_verification",
+                        "convex_knowledge_management",
+                        "convex_index_optimization",
+                    ],
+                    description: "Which methodology to explain",
+                },
+            },
+            required: ["topic"],
+        },
+        handler: async (args) => {
+            const content = METHODOLOGY_CONTENT[args.topic];
+            if (!content) {
+                return {
+                    error: `Unknown topic: ${args.topic}`,
+                    availableTopics: Object.keys(METHODOLOGY_CONTENT),
+                };
+            }
+            return {
+                ...content,
+                quickRef: getQuickRef("convex_get_methodology"),
+            };
+        },
+    },
+    {
+        name: "convex_discover_tools",
+        description: "Search for available convex-mcp-nodebench tools by keyword, category, or task description. Returns matching tools with descriptions and quickRefs to guide your next action.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "What you want to do (e.g., 'check schema', 'deploy', 'find gotchas', 'audit functions')",
+                },
+                category: {
+                    type: "string",
+                    enum: ["schema", "function", "deployment", "learning", "methodology", "integration"],
+                    description: "Optional: filter by tool category",
+                },
+            },
+            required: ["query"],
+        },
+        handler: async (args) => {
+            let results = findTools(args.query);
+            if (args.category) {
+                results = results.filter((r) => r.category === args.category);
+            }
+            return {
+                totalTools: REGISTRY.length,
+                matchingTools: results.length,
+                tools: results.map((r) => ({
+                    name: r.name,
+                    category: r.category,
+                    phase: r.phase,
+                    complexity: r.complexity,
+                    tags: r.tags,
+                    quickRef: r.quickRef,
+                })),
+                quickRef: getQuickRef("convex_discover_tools"),
+            };
+        },
+    },
+];
+//# sourceMappingURL=methodologyTools.js.map

package/dist/tools/methodologyTools.js.map

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

package/dist/tools/schemaTools.d.ts

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