nodebench-mcp 1.0.0

package/dist/tools/verificationTools.js

@@ -0,0 +1,472 @@
+/**
+ * Verification tools — 6-Phase Iterative Deep-Dive Verification Process.
+ * Guides agents through systematic verification of non-trivial implementations.
+ */
+import { getDb, genId } from "../db.js";
+const PHASE_NAMES = [
+    "context_gathering",
+    "gap_analysis",
+    "implementation",
+    "testing",
+    "self_verify",
+    "document",
+];
+const PHASE_INSTRUCTIONS = {
+    context_gathering: `Phase 1: Context Gathering (Parallel Research)
+Launch parallel research into:
+- SDK/Protocol specs: Latest versions, blogs, announcements, GitHub repos, official SDKs
+- Implementation audit: Current codebase patterns, inconsistencies, unused code
+- Dispatcher/backend audit: Function signatures, allowlists, argument shapes
+- External API research: Check if third-party APIs still work, find known breaking changes
+
+Goal: Build a comprehensive picture of "what production looks like" vs "what we have."
+TIP: Call search_learnings first to check for known issues related to this work.`,
+    gap_analysis: `Phase 2: Gap Analysis
+Compare Phase 1 findings against current implementation. For each gap found, call log_gap with:
+- severity: CRITICAL (protocol violations, security), HIGH (API incompatibilities, silent failures), MEDIUM (outdated versions, missing features), LOW (edge case handling)
+- root_cause: Why the gap exists
+- fix_strategy: How to fix it
+
+Output: A numbered gap list. Fix CRITICAL and HIGH first.`,
+    implementation: `Phase 3: Implementation
+Apply fixes following production patterns exactly. Rules:
+- Fix CRITICAL and HIGH gaps first
+- Each fix is a discrete, testable change
+- Follow the reference pattern found in Phase 1 — don't invent new patterns
+- Document why each change was made (comments in code where non-obvious)
+- Call resolve_gap as you fix each gap`,
+    testing: `Phase 4: Testing & Validation (Multi-Layer — CRITICAL)
+Run tests at all 5 layers. Call log_test_result for each:
+- Layer 1: static — TypeScript tsc --noEmit, type checking
+- Layer 2: unit — Run existing test suites, add targeted tests for fixes
+- Layer 3: integration — End-to-end flow through handler chain
+- Layer 4: manual — Spot-check critical paths with curl or direct invocation
+- Layer 5: live_e2e — Deploy to staging, hit real endpoints, verify real responses
+
+ALL layers must pass before proceeding to Phase 5.`,
+    self_verify: `Phase 5: Self-Closed-Loop Verification (Parallel Checks)
+Launch parallel verification checks, each targeting a different dimension:
+- Spec compliance: Does every response match the protocol spec exactly?
+- Functional correctness: Do tools return correct data for known inputs?
+- Argument compatibility: Do all handler-backend function pairs have matching shapes?
+
+Each check produces PASS/FAIL. Any FAIL loops back to Phase 3 (Implementation).`,
+    document: `Phase 6: Document Learnings
+Record what you discovered. For each edge case, gotcha, or pattern, call record_learning with:
+- key: Short identifier (e.g. 'convex-use-node-export-restriction')
+- content: What happened, why, and how to avoid it
+- category: edge_case | gotcha | pattern | regression | convention
+- sourceCycle: This verification cycle's ID
+
+This prevents future regressions and expands the knowledge base.`,
+};
+export const verificationTools = [
+    {
+        name: "start_verification_cycle",
+        description: "Start a new 6-phase verification cycle for a non-trivial implementation. Returns the cycle ID and Phase 1 instructions. Call this before declaring any integration, migration, or protocol-level change done.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                title: {
+                    type: "string",
+                    description: "What you are verifying (e.g. 'MCP protocol compliance', 'Auth migration')",
+                },
+                description: {
+                    type: "string",
+                    description: "Context about the change being verified",
+                },
+            },
+            required: ["title"],
+        },
+        handler: async (args) => {
+            const { title, description } = args;
+            if (!title)
+                throw new Error("Title is required");
+            const db = getDb();
+            const cycleId = genId("cycle");
+            const now = new Date().toISOString();
+            db.prepare("INSERT INTO verification_cycles (id, title, description, status, current_phase, created_at, updated_at) VALUES (?, ?, ?, 'active', 1, ?, ?)").run(cycleId, title, description ?? null, now, now);
+            // Create all 6 phase rows
+            const insertPhase = db.prepare("INSERT INTO verification_phases (id, cycle_id, phase_number, phase_name, status, started_at) VALUES (?, ?, ?, ?, ?, ?)");
+            for (let i = 0; i < PHASE_NAMES.length; i++) {
+                const phaseId = genId("phase");
+                const status = i === 0 ? "in_progress" : "pending";
+                const startedAt = i === 0 ? now : null;
+                insertPhase.run(phaseId, cycleId, i + 1, PHASE_NAMES[i], status, startedAt);
+            }
+            return {
+                cycleId,
+                title,
+                currentPhase: 1,
+                phaseName: PHASE_NAMES[0],
+                instructions: PHASE_INSTRUCTIONS[PHASE_NAMES[0]],
+                allPhases: PHASE_NAMES.map((name, i) => ({
+                    number: i + 1,
+                    name,
+                    status: i === 0 ? "in_progress" : "pending",
+                })),
+            };
+        },
+    },
+    {
+        name: "log_phase_findings",
+        description: "Record findings for the current phase of a verification cycle. Advances the cycle to the next phase if the current phase passes. If it fails, returns guidance to loop back.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                cycleId: { type: "string", description: "Verification cycle ID" },
+                phaseNumber: {
+                    type: "number",
+                    description: "Phase to record (1-6)",
+                },
+                status: {
+                    type: "string",
+                    enum: ["passed", "failed"],
+                    description: "Did this phase pass?",
+                },
+                findings: {
+                    type: "object",
+                    description: "Phase-specific structured findings",
+                },
+            },
+            required: ["cycleId", "phaseNumber", "status"],
+        },
+        handler: async (args) => {
+            const { cycleId, phaseNumber, status, findings } = args;
+            const db = getDb();
+            const now = new Date().toISOString();
+            const cycle = db
+                .prepare("SELECT * FROM verification_cycles WHERE id = ?")
+                .get(cycleId);
+            if (!cycle)
+                throw new Error(`Cycle not found: ${cycleId}`);
+            const phase = db
+                .prepare("SELECT * FROM verification_phases WHERE cycle_id = ? AND phase_number = ?")
+                .get(cycleId, phaseNumber);
+            if (!phase)
+                throw new Error(`Phase ${phaseNumber} not found in cycle`);
+            // Update this phase
+            db.prepare("UPDATE verification_phases SET status = ?, findings = ?, completed_at = ? WHERE id = ?").run(status, findings ? JSON.stringify(findings) : null, now, phase.id);
+            let nextPhase = null;
+            let nextPhaseInstructions = null;
+            let cycleComplete = false;
+            if (status === "passed") {
+                if (phaseNumber < 6) {
+                    nextPhase = phaseNumber + 1;
+                    const nextPhaseName = PHASE_NAMES[nextPhase - 1];
+                    nextPhaseInstructions = PHASE_INSTRUCTIONS[nextPhaseName];
+                    // Advance cycle and start next phase
+                    db.prepare("UPDATE verification_cycles SET current_phase = ?, updated_at = ? WHERE id = ?").run(nextPhase, now, cycleId);
+                    db.prepare("UPDATE verification_phases SET status = 'in_progress', started_at = ? WHERE cycle_id = ? AND phase_number = ?").run(now, cycleId, nextPhase);
+                }
+                else {
+                    // Phase 6 passed — cycle complete
+                    cycleComplete = true;
+                    db.prepare("UPDATE verification_cycles SET status = 'completed', updated_at = ? WHERE id = ?").run(now, cycleId);
+                }
+            }
+            else {
+                // Phase failed
+                const loopBackPhase = phaseNumber === 5 ? 3 : phaseNumber; // Phase 5 failure loops to Phase 3
+                nextPhaseInstructions = `Phase ${phaseNumber} FAILED. ${phaseNumber === 5
+                    ? "Loop back to Phase 3 (Implementation) to fix the issues found."
+                    : "Review the failures and retry this phase."}`;
+            }
+            return {
+                cycleId,
+                phaseRecorded: phaseNumber,
+                phaseStatus: status,
+                nextPhase,
+                nextPhaseInstructions,
+                cycleComplete,
+                ...(cycleComplete
+                    ? {
+                        _contributeBack: {
+                            instruction: "Cycle complete! Record what you learned so future agents benefit:",
+                            actions: [
+                                "record_learning — for each edge case, gotcha, or pattern discovered",
+                                "log_recon_finding — for any SDK/API discoveries made during research",
+                                "search_all_knowledge — check what the system already knows before your next task",
+                            ],
+                        },
+                    }
+                    : {}),
+            };
+        },
+    },
+    {
+        name: "log_gap",
+        description: "Record a gap found during Phase 2 (Gap Analysis). Gaps are categorized by severity: CRITICAL (protocol violations, security), HIGH (API incompatibilities), MEDIUM (outdated versions), LOW (edge cases).",
+        inputSchema: {
+            type: "object",
+            properties: {
+                cycleId: { type: "string", description: "Verification cycle ID" },
+                severity: {
+                    type: "string",
+                    enum: ["CRITICAL", "HIGH", "MEDIUM", "LOW"],
+                },
+                title: { type: "string", description: "Short gap description" },
+                description: { type: "string", description: "Detailed description" },
+                rootCause: { type: "string", description: "Why this gap exists" },
+                fixStrategy: { type: "string", description: "How to fix it" },
+            },
+            required: ["cycleId", "severity", "title"],
+        },
+        handler: async (args) => {
+            const { cycleId, severity, title, description, rootCause, fixStrategy } = args;
+            const db = getDb();
+            const gapId = genId("gap");
+            db.prepare("INSERT INTO gaps (id, cycle_id, severity, title, description, root_cause, fix_strategy) VALUES (?, ?, ?, ?, ?, ?, ?)").run(gapId, cycleId, severity, title, description ?? null, rootCause ?? null, fixStrategy ?? null);
+            return {
+                gapId,
+                severity,
+                title,
+                message: "Fix CRITICAL and HIGH gaps first.",
+            };
+        },
+    },
+    {
+        name: "resolve_gap",
+        description: "Mark a gap as resolved after implementing the fix. Returns remaining gap counts by severity.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                gapId: { type: "string", description: "Gap ID to resolve" },
+                resolution: {
+                    type: "string",
+                    description: "What was done to fix it",
+                },
+            },
+            required: ["gapId"],
+        },
+        handler: async (args) => {
+            const db = getDb();
+            const now = new Date().toISOString();
+            const gap = db
+                .prepare("SELECT * FROM gaps WHERE id = ?")
+                .get(args.gapId);
+            if (!gap)
+                throw new Error(`Gap not found: ${args.gapId}`);
+            db.prepare("UPDATE gaps SET status = 'resolved', fix_strategy = COALESCE(?, fix_strategy), resolved_at = ? WHERE id = ?").run(args.resolution ?? null, now, args.gapId);
+            // Count remaining open gaps for this cycle
+            const remaining = db
+                .prepare("SELECT severity, COUNT(*) as count FROM gaps WHERE cycle_id = ? AND status = 'open' GROUP BY severity")
+                .all(gap.cycle_id);
+            const counts = {
+                CRITICAL: 0,
+                HIGH: 0,
+                MEDIUM: 0,
+                LOW: 0,
+            };
+            for (const r of remaining)
+                counts[r.severity] = r.count;
+            return {
+                gapId: args.gapId,
+                status: "resolved",
+                remainingGaps: counts,
+                _contributeBack: {
+                    instruction: "Gap resolved. Record what you learned so it's searchable for future work:",
+                    actions: [
+                        "record_learning — capture the root cause and fix as a reusable pattern",
+                    ],
+                },
+            };
+        },
+    },
+    {
+        name: "log_test_result",
+        description: "Record a test result for Phase 4 (Testing & Validation). Tests are organized by layer: static, unit, integration, manual, live_e2e. All layers must pass before proceeding.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                cycleId: { type: "string", description: "Verification cycle ID" },
+                layer: {
+                    type: "string",
+                    enum: ["static", "unit", "integration", "manual", "live_e2e"],
+                    description: "Test layer",
+                },
+                label: {
+                    type: "string",
+                    description: "What was tested (e.g. 'tsc --noEmit', 'jest auth.test')",
+                },
+                passed: { type: "boolean", description: "Did the test pass?" },
+                output: {
+                    type: "string",
+                    description: "Error message or success detail",
+                },
+            },
+            required: ["cycleId", "layer", "label", "passed"],
+        },
+        handler: async (args) => {
+            const { cycleId, layer, label, passed, output } = args;
+            const db = getDb();
+            const testId = genId("test");
+            db.prepare("INSERT INTO test_results (id, cycle_id, layer, label, passed, output) VALUES (?, ?, ?, ?, ?, ?)").run(testId, cycleId, layer, label, passed ? 1 : 0, output ?? null);
+            // Summarize this layer
+            const layerResults = db
+                .prepare("SELECT passed, COUNT(*) as count FROM test_results WHERE cycle_id = ? AND layer = ? GROUP BY passed")
+                .all(cycleId, layer);
+            const layerTotal = layerResults.reduce((s, r) => s + r.count, 0);
+            const layerPassed = layerResults.find((r) => r.passed === 1)?.count ?? 0;
+            const layerFailed = layerTotal - layerPassed;
+            // Check all layers
+            const allResults = db
+                .prepare("SELECT layer, MIN(passed) as all_passed FROM test_results WHERE cycle_id = ? GROUP BY layer")
+                .all(cycleId);
+            const allLayersPassing = allResults.length > 0 &&
+                allResults.every((r) => r.all_passed === 1);
+            return {
+                testId,
+                layer,
+                passed,
+                layerSummary: {
+                    total: layerTotal,
+                    passed: layerPassed,
+                    failed: layerFailed,
+                },
+                allLayersPassing,
+            };
+        },
+    },
+    {
+        name: "get_verification_status",
+        description: "Get the current status of a verification cycle including all phases, gaps, and test results. Use this to understand where you are in the process and what to do next.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                cycleId: { type: "string", description: "Verification cycle ID" },
+            },
+            required: ["cycleId"],
+        },
+        handler: async (args) => {
+            const db = getDb();
+            const cycle = db
+                .prepare("SELECT * FROM verification_cycles WHERE id = ?")
+                .get(args.cycleId);
+            if (!cycle)
+                throw new Error(`Cycle not found: ${args.cycleId}`);
+            const phases = db
+                .prepare("SELECT * FROM verification_phases WHERE cycle_id = ? ORDER BY phase_number")
+                .all(args.cycleId);
+            const gaps = db
+                .prepare("SELECT severity, status, COUNT(*) as count FROM gaps WHERE cycle_id = ? GROUP BY severity, status")
+                .all(args.cycleId);
+            const tests = db
+                .prepare("SELECT layer, passed, COUNT(*) as count FROM test_results WHERE cycle_id = ? GROUP BY layer, passed")
+                .all(args.cycleId);
+            const completedPhases = phases.filter((p) => p.status === "passed").length;
+            const progress = Math.round((completedPhases / 6) * 100);
+            const currentPhaseName = PHASE_NAMES[cycle.current_phase - 1];
+            const nextAction = cycle.status === "completed"
+                ? "Cycle complete. Consider promoting findings to eval suite with promote_to_eval."
+                : PHASE_INSTRUCTIONS[currentPhaseName];
+            return {
+                cycleId: cycle.id,
+                title: cycle.title,
+                status: cycle.status,
+                currentPhase: cycle.current_phase,
+                progress: `${progress}%`,
+                phases: phases.map((p) => ({
+                    number: p.phase_number,
+                    name: p.phase_name,
+                    status: p.status,
+                    findings: p.findings ? JSON.parse(p.findings) : null,
+                })),
+                gaps: gaps.map((g) => ({
+                    severity: g.severity,
+                    status: g.status,
+                    count: g.count,
+                })),
+                tests: tests.map((t) => ({
+                    layer: t.layer,
+                    passed: t.passed === 1,
+                    count: t.count,
+                })),
+                nextAction,
+            };
+        },
+    },
+    {
+        name: "list_verification_cycles",
+        description: "List all verification cycles, optionally filtered by status. Use this to find a cycle ID or review past verifications.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                status: {
+                    type: "string",
+                    enum: ["active", "completed", "abandoned"],
+                    description: "Filter by status (optional, returns all if omitted)",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max results (default 20)",
+                },
+            },
+        },
+        handler: async (args) => {
+            const db = getDb();
+            const limit = args.limit ?? 20;
+            const rows = args.status
+                ? db
+                    .prepare("SELECT * FROM verification_cycles WHERE status = ? ORDER BY created_at DESC LIMIT ?")
+                    .all(args.status, limit)
+                : db
+                    .prepare("SELECT * FROM verification_cycles ORDER BY created_at DESC LIMIT ?")
+                    .all(limit);
+            return {
+                count: rows.length,
+                cycles: rows.map((r) => ({
+                    cycleId: r.id,
+                    title: r.title,
+                    status: r.status,
+                    currentPhase: r.current_phase,
+                    createdAt: r.created_at,
+                    updatedAt: r.updated_at,
+                })),
+            };
+        },
+    },
+    {
+        name: "abandon_cycle",
+        description: "Abandon an active verification cycle that will not be completed. Use this to clean up orphaned or stale cycles.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                cycleId: {
+                    type: "string",
+                    description: "The verification cycle ID to abandon",
+                },
+                reason: {
+                    type: "string",
+                    description: "Why this cycle is being abandoned (optional)",
+                },
+            },
+            required: ["cycleId"],
+        },
+        handler: async (args) => {
+            const db = getDb();
+            const cycle = db
+                .prepare("SELECT * FROM verification_cycles WHERE id = ?")
+                .get(args.cycleId);
+            if (!cycle)
+                throw new Error(`Cycle not found: ${args.cycleId}`);
+            if (cycle.status !== "active") {
+                return {
+                    skipped: true,
+                    reason: `Cycle is already '${cycle.status}', cannot abandon`,
+                    cycleId: args.cycleId,
+                };
+            }
+            const now = new Date().toISOString();
+            db.prepare("UPDATE verification_cycles SET status = 'abandoned', updated_at = ? WHERE id = ?").run(now, args.cycleId);
+            return {
+                abandoned: true,
+                cycleId: args.cycleId,
+                title: cycle.title,
+                reason: args.reason ?? "No reason provided",
+                abandonedAt: now,
+            };
+        },
+    },
+];
+//# sourceMappingURL=verificationTools.js.map

package/dist/tools/verificationTools.js.map

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

package/dist/tools/visionTools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Vision tools — AI-powered visual analysis, environment discovery, and image manipulation.
+ * Enables the agentic vision loop: Capture → Analyze → Manipulate → Iterate → Gate.
+ *
+ * - discover_vision_env: Scans for available API keys and SDKs
+ * - analyze_screenshot: Sends screenshots to vision models for analysis
+ * - manipulate_screenshot: Crop, resize, annotate images using sharp
+ *
+ * All AI SDKs and sharp are optional dependencies — tools fail gracefully if missing.
+ */
+import type { McpTool } from "../types.js";
+export declare const visionTools: McpTool[];