@homenshum/convex-mcp-nodebench 0.1.0

package/dist/tools/toolRegistry.js

@@ -0,0 +1,308 @@
+export const REGISTRY = [
+    // ── Schema Tools ──────────────────────────
+    {
+        name: "convex_audit_schema",
+        category: "schema",
+        tags: ["schema", "audit", "anti-pattern", "index", "validator"],
+        quickRef: {
+            nextAction: "Run convex_check_validator_coverage to ensure all functions have arg + return validators",
+            nextTools: ["convex_check_validator_coverage", "convex_suggest_indexes"],
+            methodology: "convex_schema_audit",
+            relatedGotchas: ["system_fields_auto", "index_field_order", "field_no_dollar_underscore"],
+            confidence: "high",
+        },
+        phase: "audit",
+        complexity: "medium",
+    },
+    {
+        name: "convex_suggest_indexes",
+        category: "schema",
+        tags: ["index", "performance", "query", "optimization"],
+        quickRef: {
+            nextAction: "Review suggested indexes and add them to schema.ts",
+            nextTools: ["convex_audit_schema", "convex_pre_deploy_gate"],
+            methodology: "convex_schema_audit",
+            relatedGotchas: ["index_field_order", "index_name_include_fields"],
+            confidence: "medium",
+        },
+        phase: "audit",
+        complexity: "medium",
+    },
+    {
+        name: "convex_check_validator_coverage",
+        category: "schema",
+        tags: ["validator", "coverage", "args", "returns", "compliance"],
+        quickRef: {
+            nextAction: "Fix any functions missing arg or return validators",
+            nextTools: ["convex_audit_functions", "convex_pre_deploy_gate"],
+            methodology: "convex_function_compliance",
+            relatedGotchas: ["returns_validator_required", "new_function_syntax"],
+            confidence: "high",
+        },
+        phase: "audit",
+        complexity: "low",
+    },
+    // ── Function Tools ────────────────────────
+    {
+        name: "convex_audit_functions",
+        category: "function",
+        tags: ["function", "audit", "public", "internal", "registration"],
+        quickRef: {
+            nextAction: "Review flagged functions and fix registration issues",
+            nextTools: ["convex_check_function_refs", "convex_check_validator_coverage"],
+            methodology: "convex_function_compliance",
+            relatedGotchas: ["internal_for_private", "function_ref_not_direct", "action_from_action"],
+            confidence: "high",
+        },
+        phase: "audit",
+        complexity: "medium",
+    },
+    {
+        name: "convex_check_function_refs",
+        category: "function",
+        tags: ["function", "reference", "api", "internal", "import"],
+        quickRef: {
+            nextAction: "Fix broken function references",
+            nextTools: ["convex_audit_functions", "convex_pre_deploy_gate"],
+            methodology: "convex_function_compliance",
+            relatedGotchas: ["function_ref_not_direct", "no_register_via_api", "circular_type_annotation"],
+            confidence: "high",
+        },
+        phase: "audit",
+        complexity: "medium",
+    },
+    // ── Deployment Tools ──────────────────────
+    {
+        name: "convex_pre_deploy_gate",
+        category: "deployment",
+        tags: ["deploy", "gate", "pre-deploy", "quality", "check"],
+        quickRef: {
+            nextAction: "Fix all blockers before running npx convex deploy",
+            nextTools: ["convex_check_env_vars", "convex_audit_schema"],
+            methodology: "convex_deploy_verification",
+            relatedGotchas: [],
+            confidence: "high",
+        },
+        phase: "deploy",
+        complexity: "high",
+    },
+    {
+        name: "convex_check_env_vars",
+        category: "deployment",
+        tags: ["env", "environment", "variables", "config", "deploy"],
+        quickRef: {
+            nextAction: "Set missing environment variables before deploying",
+            nextTools: ["convex_pre_deploy_gate"],
+            methodology: "convex_deploy_verification",
+            relatedGotchas: [],
+            confidence: "high",
+        },
+        phase: "deploy",
+        complexity: "low",
+    },
+    // ── Learning Tools ────────────────────────
+    {
+        name: "convex_record_gotcha",
+        category: "learning",
+        tags: ["gotcha", "learning", "edge-case", "record", "persist"],
+        quickRef: {
+            nextAction: "Search gotchas before your next Convex implementation to avoid repeating mistakes",
+            nextTools: ["convex_search_gotchas"],
+            methodology: "convex_knowledge_management",
+            relatedGotchas: [],
+            confidence: "high",
+        },
+        phase: "learn",
+        complexity: "low",
+    },
+    {
+        name: "convex_search_gotchas",
+        category: "learning",
+        tags: ["gotcha", "search", "knowledge", "lookup", "fts"],
+        quickRef: {
+            nextAction: "Apply relevant gotchas to your current implementation",
+            nextTools: ["convex_record_gotcha", "convex_get_methodology"],
+            methodology: "convex_knowledge_management",
+            relatedGotchas: [],
+            confidence: "high",
+        },
+        phase: "learn",
+        complexity: "low",
+    },
+    // ── Methodology Tools ─────────────────────
+    {
+        name: "convex_get_methodology",
+        category: "methodology",
+        tags: ["methodology", "guide", "how-to", "steps", "workflow"],
+        quickRef: {
+            nextAction: "Follow the methodology steps in order",
+            nextTools: ["convex_discover_tools"],
+            methodology: "overview",
+            relatedGotchas: [],
+            confidence: "high",
+        },
+        phase: "meta",
+        complexity: "low",
+    },
+    {
+        name: "convex_discover_tools",
+        category: "methodology",
+        tags: ["discover", "find", "search", "tools", "help"],
+        quickRef: {
+            nextAction: "Use the discovered tool to proceed with your task",
+            nextTools: [],
+            methodology: "overview",
+            relatedGotchas: [],
+            confidence: "high",
+        },
+        phase: "meta",
+        complexity: "low",
+    },
+    // ── Integration Bridge Tools ──────────
+    {
+        name: "convex_generate_rules_md",
+        category: "integration",
+        tags: ["rules", "generate", "markdown", "sync", "knowledge"],
+        quickRef: {
+            nextAction: "Review generated rules and commit to .windsurf/rules/ or .cursor/rules/",
+            nextTools: ["convex_search_gotchas", "convex_audit_schema"],
+            methodology: "convex_knowledge_management",
+            relatedGotchas: [],
+            confidence: "high",
+        },
+        phase: "learn",
+        complexity: "low",
+    },
+    {
+        name: "convex_snapshot_schema",
+        category: "schema",
+        tags: ["snapshot", "diff", "history", "schema", "track"],
+        quickRef: {
+            nextAction: "Make your schema changes, then snapshot again to see the diff",
+            nextTools: ["convex_audit_schema", "convex_suggest_indexes"],
+            methodology: "convex_schema_audit",
+            relatedGotchas: ["index_field_order", "system_fields_auto"],
+            confidence: "high",
+        },
+        phase: "audit",
+        complexity: "low",
+    },
+    {
+        name: "convex_bootstrap_project",
+        category: "integration",
+        tags: ["bootstrap", "health", "scan", "project", "onboard"],
+        quickRef: {
+            nextAction: "Fix criticals first, then warnings, then run full audit suite",
+            nextTools: ["convex_audit_schema", "convex_audit_functions", "convex_pre_deploy_gate"],
+            methodology: "convex_deploy_verification",
+            relatedGotchas: [],
+            confidence: "high",
+        },
+        phase: "audit",
+        complexity: "medium",
+    },
+    // ── Cron & Component Tools ────────────
+    {
+        name: "convex_check_crons",
+        category: "deployment",
+        tags: ["cron", "schedule", "interval", "daily", "weekly", "jobs"],
+        quickRef: {
+            nextAction: "Fix any critical cron issues (duplicate names, public handlers) before deploy",
+            nextTools: ["convex_pre_deploy_gate", "convex_check_env_vars"],
+            methodology: "convex_deploy_verification",
+            relatedGotchas: ["internal_for_private"],
+            confidence: "high",
+        },
+        phase: "deploy",
+        complexity: "low",
+    },
+    {
+        name: "convex_analyze_components",
+        category: "integration",
+        tags: ["component", "config", "plugin", "agent", "workflow", "rag", "module"],
+        quickRef: {
+            nextAction: "Verify all components are properly imported and used, remove unused ones",
+            nextTools: ["convex_pre_deploy_gate", "convex_audit_schema"],
+            methodology: "convex_deploy_verification",
+            relatedGotchas: [],
+            confidence: "high",
+        },
+        phase: "audit",
+        complexity: "low",
+    },
+];
+export function getQuickRef(toolName) {
+    const entry = REGISTRY.find((e) => e.name === toolName);
+    return entry?.quickRef ?? null;
+}
+export function getToolsByCategory(category) {
+    return REGISTRY.filter((e) => e.category === category);
+}
+// ── BM25-scored tool discovery with field weighting ──────────────────────
+function tokenize(text) {
+    return text.toLowerCase().match(/[a-z_]+/g) ?? [];
+}
+let _bm25Index = null;
+function getBM25Index() {
+    if (_bm25Index)
+        return _bm25Index;
+    const corpus = new Map();
+    for (const entry of REGISTRY) {
+        // Weight fields: name tokens appear 3x, tags 2x, category/phase 1x
+        const nameTokens = tokenize(entry.name);
+        const tagTokens = tokenize(entry.tags.join(" "));
+        const catTokens = tokenize(`${entry.category} ${entry.phase}`);
+        const tokens = [
+            ...nameTokens, ...nameTokens, ...nameTokens, // 3x name weight
+            ...tagTokens, ...tagTokens, // 2x tag weight
+            ...catTokens, // 1x category/phase
+        ];
+        corpus.set(entry.name, tokens);
+    }
+    let totalLen = 0;
+    for (const tokens of corpus.values())
+        totalLen += tokens.length;
+    const avgDl = corpus.size > 0 ? totalLen / corpus.size : 1;
+    const docFreq = new Map();
+    for (const tokens of corpus.values()) {
+        const unique = new Set(tokens);
+        for (const t of unique)
+            docFreq.set(t, (docFreq.get(t) ?? 0) + 1);
+    }
+    const N = corpus.size;
+    const idf = new Map();
+    for (const [term, df] of docFreq) {
+        idf.set(term, Math.log((N - df + 0.5) / (df + 0.5) + 1));
+    }
+    _bm25Index = { corpus, docLengths: new Map([...corpus].map(([k, v]) => [k, v.length])), avgDl, idf };
+    return _bm25Index;
+}
+export function findTools(query) {
+    const queryTokens = tokenize(query);
+    if (queryTokens.length === 0)
+        return [];
+    const index = getBM25Index();
+    const k1 = 1.2;
+    const b = 0.75;
+    const scored = REGISTRY.map((entry) => {
+        const docTokens = index.corpus.get(entry.name) ?? [];
+        const dl = index.docLengths.get(entry.name) ?? 1;
+        const tf = new Map();
+        for (const t of docTokens)
+            tf.set(t, (tf.get(t) ?? 0) + 1);
+        let score = 0;
+        for (const qt of queryTokens) {
+            const termTf = tf.get(qt) ?? 0;
+            if (termTf === 0)
+                continue;
+            const termIdf = index.idf.get(qt) ?? 0;
+            score += termIdf * (termTf * (k1 + 1)) / (termTf + k1 * (1 - b + b * (dl / index.avgDl)));
+        }
+        return { entry, score };
+    });
+    return scored
+        .filter((s) => s.score > 0)
+        .sort((a, b) => b.score - a.score)
+        .map((s) => s.entry);
+}
+//# sourceMappingURL=toolRegistry.js.map

package/dist/tools/toolRegistry.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,44 @@
+export type McpTool = {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    handler: (args: any) => Promise<unknown>;
+};
+export interface ConvexQuickRef {
+    nextAction: string;
+    nextTools: string[];
+    methodology: string;
+    relatedGotchas: string[];
+    confidence: "high" | "medium" | "low";
+}
+export interface ToolRegistryEntry {
+    name: string;
+    category: "schema" | "function" | "deployment" | "learning" | "methodology" | "integration";
+    tags: string[];
+    quickRef: ConvexQuickRef;
+    phase: "audit" | "implement" | "test" | "deploy" | "learn" | "meta";
+    complexity: "low" | "medium" | "high";
+}
+export interface SchemaIssue {
+    severity: "critical" | "warning" | "info";
+    location: string;
+    message: string;
+    fix: string;
+    gotchaKey?: string;
+}
+export interface FunctionIssue {
+    severity: "critical" | "warning" | "info";
+    location: string;
+    functionName: string;
+    message: string;
+    fix: string;
+}
+export interface DeployGateResult {
+    passed: boolean;
+    checks: Array<{
+        name: string;
+        passed: boolean;
+        message: string;
+    }>;
+    blockers: string[];
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "@homenshum/convex-mcp-nodebench",
+  "version": "0.1.0",
+  "description": "Convex-specific MCP server applying NodeBench self-instruct diligence patterns to Convex development. Schema audit, function compliance, deployment gates, persistent gotcha DB, and methodology guidance. Complements Context7 (raw docs) and official Convex MCP (deployment introspection) with structured verification workflows.",
+  "type": "module",
+  "bin": {
+    "convex-mcp-nodebench": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build && npm run test"
+  },
+  "keywords": [
+    "mcp",
+    "convex",
+    "model-context-protocol",
+    "schema-audit",
+    "function-compliance",
+    "deploy-gates",
+    "gotcha-db",
+    "self-instruct",
+    "ai-agents",
+    "verification"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/HomenShum/nodebench-ai.git",
+    "directory": "packages/convex-mcp-nodebench"
+  },
+  "license": "MIT",
+  "author": "HomenShum",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4",
+    "better-sqlite3": "^11.0.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^20.11.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3",
+    "vitest": "^3.2.4"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}