nodebench-mcp 2.15.0 → 2.17.0

package/dist/tools/architectTools.js

@@ -0,0 +1,304 @@
+/**
+ * Architect Tools — Structural code analysis and concept verification.
+ *
+ * Instead of hardcoded feature tiers, these tools let agents dynamically
+ * discover what a codebase can do and what's missing. The agent searches
+ * the web for new concepts, defines the required code signatures, then
+ * uses these tools to verify and plan implementation.
+ *
+ * 3 tools:
+ * - scan_capabilities: Analyze a file for structural patterns (regex-based)
+ * - verify_concept_support: Check if a file contains required code signatures
+ * - generate_implementation_plan: Build a plan for missing signatures
+ */
+import { readFile } from "node:fs/promises";
+import { getDb, genId } from "../db.js";
+// ── DB setup ────────────────────────────────────────────────────────────────
+function ensureConceptTable() {
+    const db = getDb();
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS concept_verifications (
+      id TEXT PRIMARY KEY,
+      concept_name TEXT NOT NULL,
+      file_path TEXT NOT NULL,
+      status TEXT NOT NULL,
+      match_score REAL NOT NULL,
+      signatures_total INTEGER NOT NULL,
+      signatures_found INTEGER NOT NULL,
+      gap_list TEXT,
+      verified_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+}
+const STATE_PATTERNS = {
+    boolean_flags: { pattern: /const \[\w+, set\w+\] = useState(?:<boolean>)?\(/g, count: true },
+    complex_objects: { pattern: /const \[\w+, set\w+\] = useState<\{/g, count: true },
+    refs: { pattern: /useRef</g, count: true },
+    reducers: { pattern: /useReducer\(/g, count: true },
+    context_consumers: { pattern: /useContext\(/g, count: true },
+    effects: { pattern: /useEffect\(/g, count: true },
+    memos: { pattern: /useMemo\(/g, count: true },
+    callbacks: { pattern: /useCallback\(/g, count: true },
+};
+const LAYOUT_PATTERNS = {
+    has_overlay: { pattern: /(?:fixed|absolute)\s+inset-0|z-50|z-\[/ },
+    has_sidebar: { pattern: /w-\[.*?\].*?(?:flex|border-[lr])|sidebar|side-panel/i },
+    has_resizable: { pattern: /resize|cursor-(?:col|row)-resize|onResize/ },
+    has_grid: { pattern: /grid-cols-|display:\s*grid/ },
+    has_responsive: { pattern: /sm:|md:|lg:|xl:|@media/ },
+    has_modal: { pattern: /(?:modal|dialog)(?:Open|Visible|Show)/i },
+};
+const INTERACTION_PATTERNS = {
+    keyboard_shortcuts: { pattern: /addEventListener\(['"]keydown|onKeyDown|useHotkeys/ },
+    drag_drop: { pattern: /onDrop|onDragOver|useDrag|useDrop|draggable/ },
+    clipboard: { pattern: /navigator\.clipboard|execCommand\(['"]copy/ },
+    voice: { pattern: /SpeechRecognition|webkitSpeechRecognition|MediaRecorder/ },
+    touch: { pattern: /onTouchStart|onTouchMove|onTouchEnd/ },
+    scroll: { pattern: /onScroll|IntersectionObserver|scrollIntoView/ },
+    animation: { pattern: /framer-motion|useSpring|@keyframes|transition:/ },
+};
+const RENDERING_PATTERNS = {
+    markdown: { pattern: /ReactMarkdown|remark|rehype|marked/ },
+    code_highlighting: { pattern: /SyntaxHighlighter|Prism|highlight\.js|shiki/ },
+    math: { pattern: /KaTeX|MathJax|mathjax/ },
+    dynamic_lists: { pattern: /\.map\(\s*\(/g, count: true },
+    streaming: { pattern: /ReadableStream|EventSource|onmessage|text\/event-stream/ },
+    virtualization: { pattern: /react-window|react-virtualized|useVirtualizer/ },
+};
+const BACKEND_PATTERNS = {
+    rest_routes: { pattern: /app\.(get|post|put|patch|delete)\s*\(/g, count: true },
+    middleware: { pattern: /app\.use\(|router\.use\(|middleware/g, count: true },
+    db_queries: { pattern: /\.query\(|\.exec\(|\.prepare\(|prisma\.|knex\./g, count: true },
+    auth_guards: { pattern: /isAuthenticated|requireAuth|verifyToken|passport\.authenticate/g, count: true },
+    websocket: { pattern: /WebSocket|wss?\.|socket\.on|io\.on/ },
+    graphql: { pattern: /typeDefs|resolvers|gql`|graphql/ },
+    cron_jobs: { pattern: /cron\.|schedule\(|setInterval\(/ },
+};
+function analyzePatterns(content, patterns) {
+    const result = {};
+    for (const [key, { pattern, count }] of Object.entries(patterns)) {
+        if (count) {
+            const matches = content.match(pattern);
+            result[key] = matches ? matches.length : 0;
+        }
+        else {
+            result[key] = pattern.test(content);
+        }
+    }
+    return result;
+}
+// ── Tools ──────────────────────────────────────────────────────────────────
+export const architectTools = [
+    {
+        name: "scan_capabilities",
+        description: "Analyze a source file for structural code patterns. Returns a capability report showing what the code can structurally DO — state management (hooks, refs, reducers), layout (overlay, sidebar, grid, responsive), interactions (keyboard, drag-drop, clipboard, voice, touch), rendering (markdown, code highlighting, math, streaming), and backend patterns (REST routes, middleware, DB queries, auth guards, WebSocket). Pure regex analysis, no LLM needed.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file_path: {
+                    type: "string",
+                    description: "Absolute or relative path to the source file to analyze",
+                },
+            },
+            required: ["file_path"],
+        },
+        handler: async (args) => {
+            const content = await readFile(args.file_path, "utf-8");
+            const lines = content.split("\n").length;
+            const capabilities = {
+                file: {
+                    path: args.file_path,
+                    lines,
+                    sizeBytes: Buffer.byteLength(content, "utf-8"),
+                },
+                state_management: analyzePatterns(content, STATE_PATTERNS),
+                layout_structure: analyzePatterns(content, LAYOUT_PATTERNS),
+                interaction_patterns: analyzePatterns(content, INTERACTION_PATTERNS),
+                rendering_capabilities: analyzePatterns(content, RENDERING_PATTERNS),
+                backend_patterns: analyzePatterns(content, BACKEND_PATTERNS),
+                imports: {
+                    count: (content.match(/^import /gm) || []).length,
+                    has_react: /from ['"]react/.test(content),
+                    has_next: /from ['"]next/.test(content),
+                    has_express: /from ['"]express/.test(content),
+                    has_test_framework: /from ['"](?:vitest|jest|mocha|chai)/.test(content),
+                },
+                exports: {
+                    default_export: /export default/.test(content),
+                    named_exports: (content.match(/^export (?:const|function|class|type|interface)/gm) || []).length,
+                },
+            };
+            return capabilities;
+        },
+    },
+    {
+        name: "verify_concept_support",
+        description: "Check if a source file contains all required code signatures for a concept. Provide a concept name and a list of regex patterns that MUST exist for the concept to be considered implemented. Returns match score (0-100%), status (Fully/Partially/Not Implemented), evidence found, and gap analysis. Results are persisted to SQLite for tracking progress over time.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                file_path: {
+                    type: "string",
+                    description: "Path to the source file to verify",
+                },
+                concept_name: {
+                    type: "string",
+                    description: 'The feature/concept to verify (e.g., "Dark Mode", "Canvas Artifacts", "Real-time Collaboration")',
+                },
+                required_signatures: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: 'Regex patterns that MUST exist for the concept to be implemented. E.g., ["prefers-color-scheme", "theme.*dark", "toggle.*theme"]',
+                },
+            },
+            required: ["file_path", "concept_name", "required_signatures"],
+        },
+        handler: async (args) => {
+            ensureConceptTable();
+            const content = await readFile(args.file_path, "utf-8");
+            const found = [];
+            const missing = [];
+            for (const sig of args.required_signatures) {
+                try {
+                    const regex = new RegExp(sig, "i");
+                    if (regex.test(content)) {
+                        found.push(sig);
+                    }
+                    else {
+                        missing.push(sig);
+                    }
+                }
+                catch {
+                    // Invalid regex — treat as literal string search
+                    if (content.toLowerCase().includes(sig.toLowerCase())) {
+                        found.push(sig);
+                    }
+                    else {
+                        missing.push(sig);
+                    }
+                }
+            }
+            const score = args.required_signatures.length > 0
+                ? Math.round((found.length / args.required_signatures.length) * 100)
+                : 0;
+            const status = score === 100
+                ? "Fully Implemented"
+                : score > 50
+                    ? "Partially Implemented"
+                    : "Not Implemented";
+            // Persist to SQLite
+            const id = genId("cv");
+            const db = getDb();
+            db.prepare(`INSERT INTO concept_verifications (id, concept_name, file_path, status, match_score, signatures_total, signatures_found, gap_list)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?)`).run(id, args.concept_name, args.file_path, status, score, args.required_signatures.length, found.length, JSON.stringify(missing));
+            return {
+                id,
+                concept: args.concept_name,
+                file: args.file_path,
+                status,
+                match_score: `${score}%`,
+                signatures_total: args.required_signatures.length,
+                evidence_found: found,
+                gap_analysis: missing,
+                recommendation: missing.length === 0
+                    ? "All required signatures found. Concept is fully implemented."
+                    : missing.length <= 2
+                        ? `Nearly there — ${missing.length} signature(s) missing: ${missing.join(", ")}`
+                        : `${missing.length} of ${args.required_signatures.length} signatures missing. Major implementation work needed.`,
+            };
+        },
+    },
+    {
+        name: "generate_implementation_plan",
+        description: "Generate a structured implementation plan for missing code signatures. Takes the gap analysis from verify_concept_support and produces a step-by-step plan with per-signature requirements and injection strategies. Optionally takes the output of scan_capabilities as context to avoid conflicts with existing patterns.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                concept_name: {
+                    type: "string",
+                    description: "The concept being implemented",
+                },
+                missing_signatures: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "List of missing regex patterns from verify_concept_support gap_analysis",
+                },
+                current_context: {
+                    type: "string",
+                    description: "Brief description or JSON of the current component capabilities (from scan_capabilities output). Helps avoid conflicts.",
+                },
+                target_file: {
+                    type: "string",
+                    description: "Path to the file where changes will be made (optional, for reference)",
+                },
+            },
+            required: ["concept_name", "missing_signatures"],
+        },
+        handler: async (args) => {
+            const steps = args.missing_signatures.map((sig, i) => ({
+                step: i + 1,
+                requirement: sig,
+                description: `Inject pattern matching: ${sig}`,
+                strategy: inferStrategy(sig),
+                conflicts: args.current_context
+                    ? `Review current context for overlap with: ${sig}`
+                    : "No context provided — run scan_capabilities first for conflict detection",
+            }));
+            return {
+                concept: args.concept_name,
+                target_file: args.target_file || "(not specified)",
+                total_steps: steps.length,
+                estimated_complexity: steps.length <= 2 ? "low" : steps.length <= 5 ? "medium" : "high",
+                context_provided: !!args.current_context,
+                steps,
+                workflow: [
+                    "1. Run scan_capabilities on the target file (if not already done)",
+                    "2. Review each step below and implement in order",
+                    "3. After each step, run verify_concept_support to track progress",
+                    "4. When all signatures match, the concept is fully implemented",
+                ],
+            };
+        },
+    },
+];
+// ── Helpers ─────────────────────────────────────────────────────────────────
+function inferStrategy(signature) {
+    const lower = signature.toLowerCase();
+    // State patterns
+    if (/usestate|useref|usereducer|usecontext/i.test(lower))
+        return "Add React hook to component body (before return statement)";
+    if (/useeffect|usememo|usecallback/i.test(lower))
+        return "Add React hook — check dependency array for existing effects to avoid duplicates";
+    // Layout patterns
+    if (/grid|flex|sidebar|overlay|modal|dialog/i.test(lower))
+        return "Add CSS/layout structure to JSX return — check existing layout for nesting conflicts";
+    if (/responsive|media|breakpoint/i.test(lower))
+        return "Add responsive breakpoints — check existing Tailwind/CSS classes for conflicts";
+    // Interaction patterns
+    if (/keydown|keyboard|hotkey/i.test(lower))
+        return "Add keyboard event listener — check for existing keydown handlers to merge, not duplicate";
+    if (/drag|drop/i.test(lower))
+        return "Add drag-and-drop handlers — ensure no conflicting pointer event handlers";
+    if (/clipboard|copy/i.test(lower))
+        return "Add clipboard API call — wrap in try/catch for permission handling";
+    if (/speech|voice|recognition/i.test(lower))
+        return "Add Web Speech API — feature-detect first (not available in all browsers)";
+    // Backend patterns
+    if (/app\.\w+\(|router\.\w+\(|route/i.test(lower))
+        return "Add route handler — check existing routes for path conflicts";
+    if (/middleware|use\(/i.test(lower))
+        return "Add middleware — check execution order in middleware stack";
+    if (/query|prepare|prisma|knex/i.test(lower))
+        return "Add database query — ensure schema/migration exists for required tables";
+    if (/auth|token|passport/i.test(lower))
+        return "Add authentication logic — verify auth middleware is applied to the right routes";
+    if (/websocket|socket/i.test(lower))
+        return "Add WebSocket handler — check for existing connection managers to reuse";
+    // Rendering patterns
+    if (/markdown|remark/i.test(lower))
+        return "Add markdown renderer — install remark/rehype plugins if needed";
+    if (/highlight|syntax|prism|shiki/i.test(lower))
+        return "Add code highlighting — check bundle size impact of syntax theme";
+    return "Inject this pattern into the appropriate location in the file";
+}
+//# sourceMappingURL=architectTools.js.map

package/dist/tools/architectTools.js.map

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

package/dist/tools/emailTools.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Email Tools — Send and read emails via raw SMTP/IMAP over TLS.
+ *
+ * Zero npm dependencies — uses Node's built-in `tls` module.
+ *
+ * Environment variables:
+ * - EMAIL_USER: Email address (e.g., agent@gmail.com)
+ * - EMAIL_PASS: App password (NOT regular password for Gmail)
+ * - EMAIL_SMTP_HOST: SMTP server (default: smtp.gmail.com)
+ * - EMAIL_SMTP_PORT: SMTP port (default: 465)
+ * - EMAIL_IMAP_HOST: IMAP server (default: imap.gmail.com)
+ * - EMAIL_IMAP_PORT: IMAP port (default: 993)
+ */
+import type { McpTool } from "../types.js";
+export declare const emailTools: McpTool[];