nodebench-mcp 1.0.0

package/dist/tools/flywheelTools.js

@@ -0,0 +1,366 @@
+/**
+ * Flywheel tools — compose the 6-Phase Verification (inner loop) with
+ * Eval-Driven Development (outer loop) into the AI Flywheel.
+ */
+import { getDb, genId } from "../db.js";
+export const flywheelTools = [
+    {
+        name: "get_flywheel_status",
+        description: "Get the current state of both loops (Verification inner loop and Eval outer loop) and how they connect. Shows active verification cycles, recent eval trends, and cross-loop connections.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                includeHistory: {
+                    type: "boolean",
+                    description: "Include recent completed cycles and eval runs (default false)",
+                },
+            },
+        },
+        handler: async (args) => {
+            const db = getDb();
+            const includeHistory = args.includeHistory ?? false;
+            // Inner loop: verification cycles
+            const activeCycles = db
+                .prepare("SELECT id, title, current_phase, status, created_at FROM verification_cycles WHERE status = 'active' ORDER BY created_at DESC")
+                .all();
+            const recentCompleted = includeHistory
+                ? db
+                    .prepare("SELECT id, title, updated_at as completed_at FROM verification_cycles WHERE status = 'completed' ORDER BY updated_at DESC LIMIT 10")
+                    .all()
+                : [];
+            // Gap counts for active cycles
+            for (const cycle of activeCycles) {
+                const gaps = db
+                    .prepare("SELECT severity, COUNT(*) as count FROM gaps WHERE cycle_id = ? AND status = 'open' GROUP BY severity")
+                    .all(cycle.id);
+                cycle.gapCounts = {};
+                for (const g of gaps)
+                    cycle.gapCounts[g.severity] = g.count;
+            }
+            // Outer loop: eval runs
+            const recentRuns = db
+                .prepare("SELECT id, name, status, summary, created_at FROM eval_runs ORDER BY created_at DESC LIMIT 10")
+                .all();
+            const parsedRuns = recentRuns.map((r) => {
+                let summary = { passRate: 0, avgScore: 0 };
+                try {
+                    if (r.summary)
+                        summary = JSON.parse(r.summary);
+                }
+                catch {
+                    /* ignore */
+                }
+                return {
+                    runId: r.id,
+                    name: r.name,
+                    status: r.status,
+                    passRate: summary.passRate,
+                    avgScore: summary.avgScore,
+                };
+            });
+            // Trend detection
+            const completedRuns = parsedRuns.filter((r) => r.passRate !== undefined && r.passRate > 0);
+            let trend = {
+                direction: "insufficient_data",
+                delta: 0,
+            };
+            if (completedRuns.length >= 2) {
+                const latest = completedRuns[0].passRate;
+                const previous = completedRuns[1].passRate;
+                const delta = Math.round((latest - previous) * 100) / 100;
+                trend = {
+                    direction: delta > 0 ? "improving" : delta < 0 ? "regressing" : "stable",
+                    delta,
+                };
+            }
+            // Cross-loop connections
+            const learningsFromVerification = db
+                .prepare("SELECT COUNT(*) as count FROM learnings WHERE source_cycle IS NOT NULL")
+                .get()?.count ?? 0;
+            const totalLearnings = db.prepare("SELECT COUNT(*) as count FROM learnings").get()
+                ?.count ?? 0;
+            return {
+                innerLoop: {
+                    activeCycles: activeCycles.map((c) => ({
+                        cycleId: c.id,
+                        title: c.title,
+                        currentPhase: c.current_phase,
+                        gapCounts: c.gapCounts,
+                    })),
+                    recentCompleted,
+                },
+                outerLoop: {
+                    recentRuns: parsedRuns,
+                    trend,
+                },
+                connections: {
+                    learningsFromVerification,
+                    totalLearnings,
+                },
+            };
+        },
+    },
+    {
+        name: "promote_to_eval",
+        description: "Take findings from a completed verification cycle and promote them into eval test cases. This is how the inner loop feeds the outer loop: Phase 4 test results become eval cases, Phase 5 checklists become scoring rubrics, Phase 6 edge cases become adversarial eval cases.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                cycleId: {
+                    type: "string",
+                    description: "Completed verification cycle to promote from",
+                },
+                evalRunName: {
+                    type: "string",
+                    description: "Name for the new eval run",
+                },
+                cases: {
+                    type: "array",
+                    description: "Eval cases derived from the verification cycle",
+                    items: {
+                        type: "object",
+                        properties: {
+                            input: { type: "string" },
+                            intent: { type: "string" },
+                            expected: { type: "string" },
+                        },
+                        required: ["input", "intent"],
+                    },
+                },
+            },
+            required: ["cycleId", "evalRunName", "cases"],
+        },
+        handler: async (args) => {
+            const { cycleId, evalRunName, cases } = args;
+            if (!cases || cases.length === 0)
+                throw new Error("At least one eval case is required");
+            const db = getDb();
+            // Verify cycle exists
+            const cycle = db
+                .prepare("SELECT * FROM verification_cycles WHERE id = ?")
+                .get(cycleId);
+            if (!cycle)
+                throw new Error(`Cycle not found: ${cycleId}`);
+            const runId = genId("eval");
+            const now = new Date().toISOString();
+            db.prepare("INSERT INTO eval_runs (id, name, description, status, created_at) VALUES (?, ?, ?, 'running', ?)").run(runId, evalRunName, `Promoted from verification cycle: ${cycle.title} (${cycleId})`, now);
+            const insertCase = db.prepare("INSERT INTO eval_cases (id, run_id, input, intent, expected) VALUES (?, ?, ?, ?, ?)");
+            const caseIds = [];
+            for (const c of cases) {
+                const caseId = genId("case");
+                insertCase.run(caseId, runId, c.input, c.intent, c.expected ?? null);
+                caseIds.push(caseId);
+            }
+            return {
+                evalRunId: runId,
+                caseCount: cases.length,
+                caseIds,
+                sourceCycleId: cycleId,
+                message: "Verification findings promoted to eval suite. Record results with record_eval_result, then finalize with complete_eval_run.",
+            };
+        },
+    },
+    {
+        name: "trigger_investigation",
+        description: "When an eval run shows regression, trigger a new verification cycle to investigate. This is how the outer loop feeds the inner loop: regressions trigger 6-phase investigations.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                evalRunId: {
+                    type: "string",
+                    description: "The eval run that showed regression",
+                },
+                regressionDescription: {
+                    type: "string",
+                    description: "What regressed and hypothesis about why",
+                },
+            },
+            required: ["evalRunId", "regressionDescription"],
+        },
+        handler: async (args) => {
+            const { evalRunId, regressionDescription } = args;
+            const db = getDb();
+            // Verify eval run exists
+            const evalRun = db
+                .prepare("SELECT * FROM eval_runs WHERE id = ?")
+                .get(evalRunId);
+            if (!evalRun)
+                throw new Error(`Eval run not found: ${evalRunId}`);
+            const cycleId = genId("cycle");
+            const now = new Date().toISOString();
+            const title = `Investigation: ${regressionDescription}`;
+            const description = `Triggered by eval regression in run "${evalRun.name}" (${evalRunId}). ${regressionDescription}`;
+            db.prepare("INSERT INTO verification_cycles (id, title, description, status, current_phase, created_at, updated_at) VALUES (?, ?, ?, 'active', 1, ?, ?)").run(cycleId, title, description, now, now);
+            // Create all 6 phases
+            const phaseNames = [
+                "context_gathering",
+                "gap_analysis",
+                "implementation",
+                "testing",
+                "self_verify",
+                "document",
+            ];
+            const insertPhase = db.prepare("INSERT INTO verification_phases (id, cycle_id, phase_number, phase_name, status, started_at) VALUES (?, ?, ?, ?, ?, ?)");
+            for (let i = 0; i < phaseNames.length; i++) {
+                insertPhase.run(genId("phase"), cycleId, i + 1, phaseNames[i], i === 0 ? "in_progress" : "pending", i === 0 ? now : null);
+            }
+            return {
+                cycleId,
+                title,
+                linkedEvalRun: evalRunId,
+                phase1Instructions: `Phase 1: Context Gathering — Investigate the regression.
+The eval run "${evalRun.name}" showed regression. Research:
+- What changed since the baseline eval?
+- Which test cases failed that previously passed?
+- Is this a code change, upstream API change, or data drift?
+
+Start by calling search_learnings to check for known related issues.`,
+            };
+        },
+    },
+    {
+        name: "run_mandatory_flywheel",
+        description: "Enforce the mandatory 6-step AI Flywheel verification after any non-trivial change. All 6 steps must pass before work is considered done. Skipping is only allowed for trivial changes (typo, comment, config) with explicit justification. Real-world example: a variety-check dead-code bug was only caught by running this process after smoke tests passed.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                target: {
+                    type: "string",
+                    description: "What changed (e.g., 'auth migration', 'variety check pipeline')",
+                },
+                cycleId: {
+                    type: "string",
+                    description: "Optional: link to a verification cycle",
+                },
+                steps: {
+                    type: "array",
+                    description: "The 6 mandatory steps. All must be present: static_analysis, happy_path_test, failure_path_test, gap_analysis, fix_and_reverify, deploy_and_document",
+                    items: {
+                        type: "object",
+                        properties: {
+                            stepName: {
+                                type: "string",
+                                enum: [
+                                    "static_analysis",
+                                    "happy_path_test",
+                                    "failure_path_test",
+                                    "gap_analysis",
+                                    "fix_and_reverify",
+                                    "deploy_and_document",
+                                ],
+                            },
+                            passed: { type: "boolean" },
+                            output: {
+                                type: "string",
+                                description: "Step output or notes",
+                            },
+                        },
+                        required: ["stepName", "passed"],
+                    },
+                },
+                skipJustification: {
+                    type: "string",
+                    description: "Only if skipping all 6 steps: explain why this change is trivial (typo fix, comment update, config tweak)",
+                },
+            },
+            required: ["target"],
+        },
+        handler: async (args) => {
+            const { target, cycleId, steps, skipJustification } = args;
+            const db = getDb();
+            const now = new Date().toISOString();
+            // Skip path
+            if (skipJustification && (!steps || steps.length === 0)) {
+                const gateRunId = genId("gate");
+                db.prepare("INSERT INTO quality_gate_runs (id, gate_name, target, passed, score, total_rules, failures, rule_results, created_at) VALUES (?, 'mandatory_flywheel', ?, 1, 1.0, 0, '[]', ?, ?)").run(gateRunId, target, JSON.stringify({
+                    skipped: true,
+                    justification: skipJustification,
+                }), now);
+                return {
+                    gateRunId,
+                    passed: true,
+                    skipped: true,
+                    justification: skipJustification,
+                    guidance: "Flywheel skipped for trivial change. If the change has any behavioral impact, re-run with all 6 steps.",
+                };
+            }
+            // Validate steps
+            if (!steps || steps.length === 0) {
+                throw new Error("Either provide all 6 mandatory steps or a skipJustification for trivial changes. The 6 required steps are: static_analysis, happy_path_test, failure_path_test, gap_analysis, fix_and_reverify, deploy_and_document.");
+            }
+            const REQUIRED_STEPS = [
+                "static_analysis",
+                "happy_path_test",
+                "failure_path_test",
+                "gap_analysis",
+                "fix_and_reverify",
+                "deploy_and_document",
+            ];
+            const providedNames = steps.map((s) => s.stepName);
+            const missing = REQUIRED_STEPS.filter((r) => !providedNames.includes(r));
+            if (missing.length > 0) {
+                throw new Error(`Missing required steps: ${missing.join(", ")}. All 6 steps must be reported.`);
+            }
+            // Validate cycle exists if provided
+            if (cycleId) {
+                const cycle = db
+                    .prepare("SELECT id FROM verification_cycles WHERE id = ?")
+                    .get(cycleId);
+                if (!cycle)
+                    throw new Error(`Verification cycle not found: ${cycleId}`);
+            }
+            // Build results
+            const ruleResults = {};
+            const failures = [];
+            let firstFailure = null;
+            for (const step of steps) {
+                ruleResults[step.stepName] = step.passed;
+                if (!step.passed) {
+                    failures.push(step.stepName);
+                    if (!firstFailure)
+                        firstFailure = step.stepName;
+                }
+            }
+            const allPassed = failures.length === 0;
+            const score = Math.round(((REQUIRED_STEPS.length - failures.length) /
+                REQUIRED_STEPS.length) *
+                100) / 100;
+            const gateRunId = genId("gate");
+            db.prepare("INSERT INTO quality_gate_runs (id, gate_name, target, passed, score, total_rules, failures, rule_results, created_at) VALUES (?, 'mandatory_flywheel', ?, ?, ?, 6, ?, ?, ?)").run(gateRunId, target, allPassed ? 1 : 0, score, JSON.stringify(failures), JSON.stringify(ruleResults), now);
+            let guidance;
+            if (allPassed) {
+                guidance =
+                    "Flywheel verification complete. All 6 mandatory steps passed. Work is ready to ship.";
+            }
+            else {
+                guidance = `Failed at ${firstFailure}. Fix the issue and re-run ALL 6 steps from scratch (not just the failed step). Remember: the variety-check dead-code bug was only caught because the full flywheel was re-run after initial smoke tests passed.`;
+            }
+            return {
+                gateRunId,
+                target,
+                passed: allPassed,
+                score,
+                totalSteps: 6,
+                passedCount: REQUIRED_STEPS.length - failures.length,
+                failures,
+                firstFailure,
+                ruleResults,
+                linkedCycleId: cycleId ?? null,
+                guidance,
+                ...(allPassed
+                    ? {
+                        _contributeBack: {
+                            instruction: "All 6 steps passed. Record what you learned so the knowledge base grows automatically:",
+                            actions: [
+                                "record_learning — for edge cases, gotchas, or patterns found during verification",
+                                "log_recon_finding — for any SDK/API/framework discoveries",
+                                "search_all_knowledge — check existing knowledge before your next task",
+                            ],
+                        },
+                    }
+                    : {}),
+            };
+        },
+    },
+];
+//# sourceMappingURL=flywheelTools.js.map

package/dist/tools/flywheelTools.js.map

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

package/dist/tools/githubTools.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 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.
+ */
+import type { McpTool } from "../types.js";
+export declare const githubTools: McpTool[];