nodebench-mcp 1.0.0

package/dist/tools/githubTools.js

@@ -0,0 +1,432 @@
+/**
+ * GitHub tools — Repository search and analysis.
+ * Enables agents to discover and analyze GitHub repositories for learning patterns,
+ * finding prior art, and understanding tech stacks.
+ *
+ * - search_github: Search repositories by topic, language, stars
+ * - analyze_repo: Analyze a repo's structure, tech stack, and patterns
+ *
+ * Uses GitHub REST API. GITHUB_TOKEN optional but recommended for higher rate limits.
+ */
+// ─── GitHub API helpers ───────────────────────────────────────────────────────
+function getHeaders() {
+    const headers = {
+        Accept: "application/vnd.github+json",
+        "User-Agent": "NodeBench-MCP/1.0",
+    };
+    const token = process.env.GITHUB_TOKEN || process.env.GH_TOKEN;
+    if (token) {
+        headers.Authorization = `Bearer ${token}`;
+    }
+    return headers;
+}
+async function githubFetch(endpoint) {
+    const url = endpoint.startsWith("http")
+        ? endpoint
+        : `https://api.github.com${endpoint}`;
+    const response = await fetch(url, { headers: getHeaders() });
+    if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`GitHub API error ${response.status}: ${error}`);
+    }
+    return response.json();
+}
+// ─── Repo URL parsing ─────────────────────────────────────────────────────────
+function parseRepoUrl(url) {
+    // Handle: https://github.com/owner/repo, github.com/owner/repo, owner/repo
+    const patterns = [
+        /github\.com\/([^/]+)\/([^/]+)/,
+        /^([^/]+)\/([^/]+)$/,
+    ];
+    for (const pattern of patterns) {
+        const match = url.match(pattern);
+        if (match) {
+            return {
+                owner: match[1],
+                repo: match[2].replace(/\.git$/, ""),
+            };
+        }
+    }
+    return null;
+}
+function detectDependencies(files) {
+    const deps = {
+        dependencies: [],
+        devDependencies: [],
+        frameworks: [],
+    };
+    // Check package.json
+    const packageJson = files.get("package.json");
+    if (packageJson) {
+        try {
+            const pkg = JSON.parse(packageJson);
+            deps.dependencies = Object.keys(pkg.dependencies ?? {});
+            deps.devDependencies = Object.keys(pkg.devDependencies ?? {});
+            // Detect frameworks
+            const allDeps = [...deps.dependencies, ...deps.devDependencies];
+            if (allDeps.includes("next"))
+                deps.frameworks.push("Next.js");
+            if (allDeps.includes("react"))
+                deps.frameworks.push("React");
+            if (allDeps.includes("vue"))
+                deps.frameworks.push("Vue");
+            if (allDeps.includes("svelte"))
+                deps.frameworks.push("Svelte");
+            if (allDeps.includes("express"))
+                deps.frameworks.push("Express");
+            if (allDeps.includes("fastify"))
+                deps.frameworks.push("Fastify");
+            if (allDeps.includes("hono"))
+                deps.frameworks.push("Hono");
+            if (allDeps.includes("convex"))
+                deps.frameworks.push("Convex");
+            if (allDeps.includes("prisma") || allDeps.includes("@prisma/client"))
+                deps.frameworks.push("Prisma");
+            if (allDeps.includes("drizzle-orm"))
+                deps.frameworks.push("Drizzle");
+            if (allDeps.includes("@tanstack/react-query"))
+                deps.frameworks.push("TanStack Query");
+            if (allDeps.includes("tailwindcss"))
+                deps.frameworks.push("Tailwind CSS");
+            if (allDeps.includes("@modelcontextprotocol/sdk"))
+                deps.frameworks.push("MCP SDK");
+        }
+        catch {
+            // Invalid JSON
+        }
+    }
+    // Check requirements.txt
+    const requirements = files.get("requirements.txt");
+    if (requirements) {
+        const pythonDeps = requirements
+            .split("\n")
+            .map((line) => line.split("==")[0].split(">=")[0].trim())
+            .filter(Boolean);
+        deps.dependencies.push(...pythonDeps);
+        if (pythonDeps.includes("fastapi"))
+            deps.frameworks.push("FastAPI");
+        if (pythonDeps.includes("django"))
+            deps.frameworks.push("Django");
+        if (pythonDeps.includes("flask"))
+            deps.frameworks.push("Flask");
+        if (pythonDeps.includes("langchain"))
+            deps.frameworks.push("LangChain");
+        if (pythonDeps.includes("openai"))
+            deps.frameworks.push("OpenAI Python");
+    }
+    // Check Cargo.toml
+    const cargoToml = files.get("Cargo.toml");
+    if (cargoToml) {
+        const depMatch = cargoToml.match(/\[dependencies\]([\s\S]*?)(\[|$)/);
+        if (depMatch) {
+            const rustDeps = depMatch[1]
+                .split("\n")
+                .map((line) => line.split("=")[0].trim())
+                .filter(Boolean);
+            deps.dependencies.push(...rustDeps);
+            if (rustDeps.includes("axum"))
+                deps.frameworks.push("Axum");
+            if (rustDeps.includes("actix-web"))
+                deps.frameworks.push("Actix");
+            if (rustDeps.includes("tokio"))
+                deps.frameworks.push("Tokio");
+        }
+    }
+    return deps;
+}
+function detectPatterns(tree) {
+    const patterns = {
+        hasTests: false,
+        hasCi: false,
+        hasReadme: false,
+        hasDocs: false,
+        hasTypes: false,
+        hasDocker: false,
+        hasLicense: false,
+        testFramework: null,
+        ciPlatform: null,
+    };
+    for (const path of tree) {
+        const lower = path.toLowerCase();
+        // Tests
+        if (lower.includes("test") ||
+            lower.includes("__tests__") ||
+            lower.includes("spec")) {
+            patterns.hasTests = true;
+            if (lower.includes("vitest"))
+                patterns.testFramework = "Vitest";
+            else if (lower.includes("jest"))
+                patterns.testFramework = "Jest";
+            else if (lower.includes("pytest"))
+                patterns.testFramework = "pytest";
+            else if (lower.includes("mocha"))
+                patterns.testFramework = "Mocha";
+        }
+        // CI/CD
+        if (lower.includes(".github/workflows")) {
+            patterns.hasCi = true;
+            patterns.ciPlatform = "GitHub Actions";
+        }
+        else if (lower.includes(".circleci")) {
+            patterns.hasCi = true;
+            patterns.ciPlatform = "CircleCI";
+        }
+        else if (lower.includes("gitlab-ci")) {
+            patterns.hasCi = true;
+            patterns.ciPlatform = "GitLab CI";
+        }
+        // Docs
+        if (lower === "readme.md" || lower === "readme")
+            patterns.hasReadme = true;
+        if (lower.includes("docs/") || lower.includes("documentation/"))
+            patterns.hasDocs = true;
+        if (lower === "license" || lower === "license.md")
+            patterns.hasLicense = true;
+        // Types
+        if (lower.endsWith(".d.ts") || lower === "tsconfig.json")
+            patterns.hasTypes = true;
+        // Docker
+        if (lower.includes("dockerfile") || lower.includes("docker-compose"))
+            patterns.hasDocker = true;
+    }
+    return patterns;
+}
+// ─── Tools ────────────────────────────────────────────────────────────────────
+export const githubTools = [
+    {
+        name: "search_github",
+        description: "Search GitHub repositories by query, topic, language, and star count. Useful for discovering libraries, frameworks, prior art, and learning from existing implementations. Returns repo metadata including stars, forks, description, and topics. GITHUB_TOKEN optional but recommended for higher rate limits.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search query (e.g., 'mcp server', 'ai agents', 'typescript sdk')",
+                },
+                language: {
+                    type: "string",
+                    description: "Filter by programming language (e.g., 'typescript', 'python', 'rust')",
+                },
+                topic: {
+                    type: "string",
+                    description: "Filter by GitHub topic (e.g., 'mcp', 'ai-agents', 'llm')",
+                },
+                minStars: {
+                    type: "number",
+                    description: "Minimum star count (default: 10)",
+                },
+                sort: {
+                    type: "string",
+                    enum: ["stars", "updated", "relevance"],
+                    description: "Sort order: 'stars' (most popular), 'updated' (recently active), 'relevance' (best match). Default: 'stars'.",
+                },
+                maxResults: {
+                    type: "number",
+                    description: "Maximum results to return (default: 10, max: 30)",
+                },
+            },
+            required: ["query"],
+        },
+        handler: async (args) => {
+            const query = args.query;
+            const language = args.language;
+            const topic = args.topic;
+            const minStars = args.minStars ?? 10;
+            const sort = args.sort ?? "stars";
+            const maxResults = Math.min(args.maxResults ?? 10, 30);
+            // Build GitHub search query
+            const queryParts = [query];
+            if (language)
+                queryParts.push(`language:${language}`);
+            if (topic)
+                queryParts.push(`topic:${topic}`);
+            if (minStars > 0)
+                queryParts.push(`stars:>=${minStars}`);
+            const searchQuery = encodeURIComponent(queryParts.join(" "));
+            const sortParam = sort === "relevance" ? "" : `&sort=${sort}`;
+            try {
+                const data = await githubFetch(`/search/repositories?q=${searchQuery}${sortParam}&per_page=${maxResults}`);
+                const repos = (data.items ?? []).map((item) => ({
+                    name: item.name,
+                    fullName: item.full_name,
+                    description: item.description ?? "",
+                    url: item.html_url,
+                    stars: item.stargazers_count,
+                    forks: item.forks_count,
+                    language: item.language,
+                    topics: item.topics ?? [],
+                    updatedAt: item.updated_at,
+                    license: item.license?.spdx_id ?? null,
+                    isArchived: item.archived,
+                    openIssues: item.open_issues_count,
+                }));
+                return {
+                    query,
+                    filters: { language, topic, minStars, sort },
+                    repos,
+                    totalCount: data.total_count,
+                    resultCount: repos.length,
+                    hasGitHubToken: !!(process.env.GITHUB_TOKEN || process.env.GH_TOKEN),
+                };
+            }
+            catch (err) {
+                return {
+                    error: true,
+                    query,
+                    message: `GitHub search failed: ${err.message}`,
+                    suggestion: "Check network connectivity. Set GITHUB_TOKEN for higher rate limits (60/hour without, 5000/hour with).",
+                };
+            }
+        },
+    },
+    {
+        name: "analyze_repo",
+        description: "Analyze a GitHub repository's structure, tech stack, dependencies, and development patterns. Fetches repo metadata, file tree, and key configuration files (package.json, requirements.txt, etc.) to understand the project. No cloning required — uses GitHub API. Useful for learning from implementations, evaluating libraries, and understanding architectures.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                repoUrl: {
+                    type: "string",
+                    description: "GitHub repository URL or owner/repo (e.g., 'https://github.com/anthropics/claude-code', 'anthropics/claude-code')",
+                },
+                depth: {
+                    type: "string",
+                    enum: ["shallow", "standard", "deep"],
+                    description: "Analysis depth: 'shallow' (metadata only), 'standard' (+ file tree + key files), 'deep' (+ more files). Default: 'standard'.",
+                },
+            },
+            required: ["repoUrl"],
+        },
+        handler: async (args) => {
+            const repoUrl = args.repoUrl;
+            const depth = args.depth ?? "standard";
+            const parsed = parseRepoUrl(repoUrl);
+            if (!parsed) {
+                return {
+                    error: true,
+                    repoUrl,
+                    message: "Invalid repository URL format",
+                    suggestion: "Use format: 'owner/repo' or 'https://github.com/owner/repo'",
+                };
+            }
+            const { owner, repo } = parsed;
+            try {
+                // Fetch repo metadata
+                const repoData = await githubFetch(`/repos/${owner}/${repo}`);
+                const result = {
+                    repo: {
+                        name: repoData.name,
+                        fullName: repoData.full_name,
+                        description: repoData.description,
+                        url: repoData.html_url,
+                        stars: repoData.stargazers_count,
+                        forks: repoData.forks_count,
+                        language: repoData.language,
+                        topics: repoData.topics ?? [],
+                        createdAt: repoData.created_at,
+                        updatedAt: repoData.updated_at,
+                        pushedAt: repoData.pushed_at,
+                        defaultBranch: repoData.default_branch,
+                        license: repoData.license?.spdx_id ?? null,
+                        isArchived: repoData.archived,
+                        openIssues: repoData.open_issues_count,
+                    },
+                    depth,
+                    analyzedAt: new Date().toISOString(),
+                };
+                if (depth === "shallow") {
+                    return result;
+                }
+                // Fetch file tree
+                const defaultBranch = repoData.default_branch ?? "main";
+                const treeData = await githubFetch(`/repos/${owner}/${repo}/git/trees/${defaultBranch}?recursive=1`);
+                const tree = (treeData.tree ?? [])
+                    .filter((item) => item.type === "blob")
+                    .map((item) => item.path);
+                // Analyze structure
+                const directories = new Set();
+                for (const path of tree) {
+                    const parts = path.split("/");
+                    for (let i = 1; i < parts.length; i++) {
+                        directories.add(parts.slice(0, i).join("/"));
+                    }
+                }
+                const keyFiles = tree.filter((path) => {
+                    const name = path.toLowerCase();
+                    return (name === "readme.md" ||
+                        name === "package.json" ||
+                        name === "tsconfig.json" ||
+                        name === "requirements.txt" ||
+                        name === "cargo.toml" ||
+                        name === "go.mod" ||
+                        name === "dockerfile" ||
+                        name.includes("docker-compose") ||
+                        name === ".env.example" ||
+                        name === "agents.md");
+                });
+                result.structure = {
+                    directories: Array.from(directories).slice(0, 50),
+                    keyFiles,
+                    fileCount: tree.length,
+                    truncated: treeData.truncated ?? false,
+                };
+                // Detect patterns
+                result.patterns = detectPatterns(tree);
+                // Fetch key files for dependency analysis
+                const filesToFetch = ["package.json", "requirements.txt", "Cargo.toml"];
+                const fetchedFiles = new Map();
+                for (const filename of filesToFetch) {
+                    if (tree.includes(filename)) {
+                        try {
+                            const fileData = await githubFetch(`/repos/${owner}/${repo}/contents/${filename}`);
+                            if (fileData.content) {
+                                const content = Buffer.from(fileData.content, "base64").toString("utf-8");
+                                fetchedFiles.set(filename, content);
+                            }
+                        }
+                        catch {
+                            // File not accessible
+                        }
+                    }
+                }
+                // Detect tech stack
+                const deps = detectDependencies(fetchedFiles);
+                result.techStack = {
+                    primaryLanguage: repoData.language,
+                    languages: {}, // Would need languages API call
+                    dependencies: deps.dependencies.slice(0, 30),
+                    devDependencies: deps.devDependencies.slice(0, 20),
+                    frameworksDetected: deps.frameworks,
+                };
+                // Generate recommendation
+                const recommendations = [];
+                if (!result.patterns.hasReadme)
+                    recommendations.push("Add a README.md");
+                if (!result.patterns.hasTests)
+                    recommendations.push("Add tests");
+                if (!result.patterns.hasCi)
+                    recommendations.push("Set up CI/CD");
+                if (!result.patterns.hasTypes && repoData.language === "TypeScript")
+                    recommendations.push("Ensure TypeScript types are exported");
+                if (!result.patterns.hasLicense)
+                    recommendations.push("Add a license");
+                result.recommendation =
+                    recommendations.length > 0
+                        ? `Suggestions: ${recommendations.join(", ")}`
+                        : "Repository follows good practices (README, tests, CI, license detected).";
+                return result;
+            }
+            catch (err) {
+                return {
+                    error: true,
+                    repoUrl,
+                    owner,
+                    repo,
+                    message: `Repository analysis failed: ${err.message}`,
+                    suggestion: "Check that the repository exists and is public. Set GITHUB_TOKEN for private repos or higher rate limits.",
+                };
+            }
+        },
+    },
+];
+//# sourceMappingURL=githubTools.js.map

package/dist/tools/githubTools.js.map

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

package/dist/tools/learningTools.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Learning tools — persistent edge case / gotcha / pattern store backed by SQLite FTS5.
+ * Reframed from generic "agent memory" to development learnings that prevent repeating mistakes.
+ */
+import type { McpTool } from "../types.js";
+export declare const learningTools: McpTool[];

package/dist/tools/learningTools.js

@@ -0,0 +1,199 @@
+/**
+ * Learning tools — persistent edge case / gotcha / pattern store backed by SQLite FTS5.
+ * Reframed from generic "agent memory" to development learnings that prevent repeating mistakes.
+ */
+import { getDb } from "../db.js";
+export const learningTools = [
+    {
+        name: "record_learning",
+        description: "Store an edge case, gotcha, pattern, or regression discovered during verification. Learnings are searchable via full-text search and prevent repeating the same mistakes. Always record learnings at the end of a verification cycle.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                key: {
+                    type: "string",
+                    description: "Short identifier (e.g. 'convex-use-node-export-restriction', 'stooq-crypto-suffix')",
+                },
+                content: {
+                    type: "string",
+                    description: "The learning: what happened, why, and how to avoid it",
+                },
+                category: {
+                    type: "string",
+                    enum: ["edge_case", "gotcha", "pattern", "regression", "convention"],
+                    description: "Type of learning",
+                },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Searchable tags",
+                },
+                sourceCycle: {
+                    type: "string",
+                    description: "Verification cycle ID that produced this learning (optional)",
+                },
+            },
+            required: ["key", "content", "category"],
+        },
+        handler: async (args) => {
+            const { key, content, category, tags, sourceCycle } = args;
+            if (!key || !content)
+                throw new Error("Key and content are required");
+            const db = getDb();
+            const now = new Date().toISOString();
+            const tagsJson = tags ? JSON.stringify(tags) : null;
+            db.prepare(`
+        INSERT INTO learnings (key, content, category, tags, source_cycle, created_at, updated_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?)
+        ON CONFLICT(key) DO UPDATE SET
+          content = excluded.content,
+          category = excluded.category,
+          tags = excluded.tags,
+          source_cycle = excluded.source_cycle,
+          updated_at = excluded.updated_at
+      `).run(key, content, category, tagsJson, sourceCycle ?? null, now, now);
+            const row = db
+                .prepare("SELECT id FROM learnings WHERE key = ?")
+                .get(key);
+            return {
+                success: true,
+                learningId: row?.id,
+                key,
+                category,
+                message: `Learning recorded. It will surface in future searches.`,
+            };
+        },
+    },
+    {
+        name: "search_learnings",
+        description: "Search past learnings before making changes. This prevents repeating known mistakes. Always search learnings at the start of a verification cycle or before implementing a fix.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "What you are about to work on (e.g. 'convex http routing', 'crypto price API')",
+                },
+                category: {
+                    type: "string",
+                    enum: ["edge_case", "gotcha", "pattern", "regression", "convention"],
+                    description: "Filter by category (optional)",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max results (default 10)",
+                },
+            },
+            required: ["query"],
+        },
+        handler: async (args) => {
+            const db = getDb();
+            const limit = args.limit ?? 10;
+            const query = args.query;
+            let results;
+            if (args.category) {
+                results = db
+                    .prepare(`
+          SELECT l.id, l.key, l.content, l.category, l.tags, l.source_cycle, l.created_at,
+                 rank
+          FROM learnings_fts
+          JOIN learnings l ON l.id = learnings_fts.rowid
+          WHERE learnings_fts MATCH ?
+            AND l.category = ?
+          ORDER BY rank
+          LIMIT ?
+        `)
+                    .all(query, args.category, limit);
+            }
+            else {
+                results = db
+                    .prepare(`
+          SELECT l.id, l.key, l.content, l.category, l.tags, l.source_cycle, l.created_at,
+                 rank
+          FROM learnings_fts
+          JOIN learnings l ON l.id = learnings_fts.rowid
+          WHERE learnings_fts MATCH ?
+          ORDER BY rank
+          LIMIT ?
+        `)
+                    .all(query, limit);
+            }
+            return {
+                query,
+                count: results.length,
+                learnings: results.map((r) => ({
+                    key: r.key,
+                    content: r.content,
+                    category: r.category,
+                    tags: r.tags ? JSON.parse(r.tags) : [],
+                    sourceCycle: r.source_cycle,
+                    createdAt: r.created_at,
+                })),
+            };
+        },
+    },
+    {
+        name: "list_learnings",
+        description: "List all stored learnings, optionally filtered by category. Use this to review the knowledge base.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                category: {
+                    type: "string",
+                    enum: ["edge_case", "gotcha", "pattern", "regression", "convention"],
+                    description: "Filter by category (optional)",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max results (default 50)",
+                },
+            },
+        },
+        handler: async (args) => {
+            const db = getDb();
+            const limit = args.limit ?? 50;
+            const rows = args.category
+                ? db
+                    .prepare("SELECT * FROM learnings WHERE category = ? ORDER BY created_at DESC LIMIT ?")
+                    .all(args.category, limit)
+                : db
+                    .prepare("SELECT * FROM learnings ORDER BY created_at DESC LIMIT ?")
+                    .all(limit);
+            return {
+                count: rows.length,
+                learnings: rows.map((r) => ({
+                    key: r.key,
+                    content: r.content,
+                    category: r.category,
+                    tags: r.tags ? JSON.parse(r.tags) : [],
+                    sourceCycle: r.source_cycle,
+                    createdAt: r.created_at,
+                })),
+            };
+        },
+    },
+    {
+        name: "delete_learning",
+        description: "Delete a learning by key. Use when a learning is outdated or incorrect.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                key: { type: "string", description: "Key of the learning to delete" },
+            },
+            required: ["key"],
+        },
+        handler: async (args) => {
+            const db = getDb();
+            const result = db
+                .prepare("DELETE FROM learnings WHERE key = ?")
+                .run(args.key);
+            if (result.changes === 0)
+                throw new Error(`No learning found for key: ${args.key}`);
+            return {
+                success: true,
+                message: `Deleted learning '${args.key}'`,
+            };
+        },
+    },
+];
+//# sourceMappingURL=learningTools.js.map