nodebench-mcp 2.14.2 → 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/critterTools.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Critter Tools — The accountability partner that wants to know everything.
+ *
+ * Like a girlfriend who asks "so why are you doing this? who is it for?" —
+ * annoying in the moment, but actually a great productivity enhancer.
+ * The friction is the feature: making agents slow down to articulate purpose
+ * and audience prevents scope creep, cargo-cult coding, and aimless exploration.
+ *
+ * What critter catches:
+ * - Circular reasoning ("I'm adding auth because we need auth")
+ * - Vague audiences ("it's for users" — which users? doing what?)
+ * - Deference over understanding ("because the ticket says so")
+ * - Missing success criteria (how will you know it worked?)
+ *
+ * Inspired by daily intentionality questions that surface clarity from chaos.
+ *
+ * 1 tool:
+ * - critter_check: Submit a task + why + who for intentionality scoring
+ */
+import type { McpTool } from "../types.js";
+export declare const critterTools: McpTool[];

package/dist/tools/critterTools.js

@@ -0,0 +1,230 @@
+/**
+ * Critter Tools — The accountability partner that wants to know everything.
+ *
+ * Like a girlfriend who asks "so why are you doing this? who is it for?" —
+ * annoying in the moment, but actually a great productivity enhancer.
+ * The friction is the feature: making agents slow down to articulate purpose
+ * and audience prevents scope creep, cargo-cult coding, and aimless exploration.
+ *
+ * What critter catches:
+ * - Circular reasoning ("I'm adding auth because we need auth")
+ * - Vague audiences ("it's for users" — which users? doing what?)
+ * - Deference over understanding ("because the ticket says so")
+ * - Missing success criteria (how will you know it worked?)
+ *
+ * Inspired by daily intentionality questions that surface clarity from chaos.
+ *
+ * 1 tool:
+ * - critter_check: Submit a task + why + who for intentionality scoring
+ */
+import { getDb, genId } from "../db.js";
+// ── DB setup ────────────────────────────────────────────────────────────────
+function ensureCritterTable() {
+    const db = getDb();
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS critter_checks (
+      id TEXT PRIMARY KEY,
+      task TEXT NOT NULL,
+      why TEXT NOT NULL,
+      who TEXT NOT NULL,
+      success_looks_like TEXT,
+      simplest_version TEXT,
+      score INTEGER NOT NULL,
+      verdict TEXT NOT NULL,
+      feedback TEXT NOT NULL,
+      created_at TEXT NOT NULL DEFAULT (datetime('now'))
+    )
+  `);
+}
+function scoreCritterCheck(input) {
+    const feedback = [];
+    let score = 100;
+    const taskLower = input.task.toLowerCase().trim();
+    const whyLower = input.why.toLowerCase().trim();
+    const whoLower = input.who.toLowerCase().trim();
+    // ── Check 1: Circular reasoning — "why" just restates the task ────────
+    const taskWords = new Set(taskLower.split(/\s+/).filter((w) => w.length > 3));
+    const whyWords = whyLower.split(/\s+/).filter((w) => w.length > 3);
+    const overlap = whyWords.filter((w) => taskWords.has(w));
+    if (whyWords.length > 0 && overlap.length / whyWords.length > 0.5) {
+        score -= 30;
+        feedback.push("Circular: your 'why' mostly restates the task. Dig deeper — what outcome does this enable?");
+    }
+    // ── Check 2: Vague audience ───────────────────────────────────────────
+    const vagueAudiences = ["users", "everyone", "people", "the team", "stakeholders", "clients", "customers", "developers"];
+    if (vagueAudiences.includes(whoLower)) {
+        score -= 20;
+        feedback.push(`Vague audience: "${input.who}" is too broad. Who specifically benefits? Name a role, persona, or individual.`);
+    }
+    // ── Check 3: Empty or trivially short responses ───────────────────────
+    if (whyLower.length === 0) {
+        score -= 40;
+        feedback.push("Empty 'why': you haven't stated any purpose at all. Why does this work matter?");
+    }
+    else if (whyLower.length < 10) {
+        score -= 25;
+        feedback.push("The 'why' is too short. A clear purpose needs at least a full sentence.");
+    }
+    if (whoLower.length < 3) {
+        score -= 25;
+        feedback.push("The 'who' is too short. Specify who benefits from this work.");
+    }
+    // ── Check 4: "Because I was told to" or "it's in the ticket" ─────────
+    const deferPatterns = [
+        "was told", "asked to", "ticket says", "was asked", "requirement says",
+        "spec says", "jira", "because I was", "they said", "assigned to me",
+    ];
+    if (deferPatterns.some((p) => whyLower.includes(p))) {
+        score -= 15;
+        feedback.push("Deference detected: you're citing authority rather than understanding purpose. Why does this matter beyond the ticket?");
+    }
+    // ── Check 5: Non-answer patterns — explicit "I don't know" ───────────
+    const nonAnswerPatterns = [
+        "just because", "don't know", "not sure", "why not", "might need it",
+        "no reason", "no idea", "whatever", "idk", "tbd",
+    ];
+    const nonAnswerHits = nonAnswerPatterns.filter((p) => whyLower.includes(p)).length;
+    if (nonAnswerHits > 0) {
+        const nonAnswerPenalty = Math.min(nonAnswerHits * 20, 40); // -20 per match, cap -40
+        score -= nonAnswerPenalty;
+        feedback.push("Non-answer: your 'why' signals you haven't figured out the purpose yet. What specific problem does this solve?");
+    }
+    // ── Check 6: Repetitive padding — same words repeated to fake length ──
+    const whyAllWords = whyLower.split(/\s+/).filter((w) => w.length > 2);
+    if (whyAllWords.length >= 5) {
+        const whyUniqueWords = new Set(whyAllWords);
+        if (whyUniqueWords.size / whyAllWords.length < 0.4) {
+            score -= 25;
+            feedback.push("Repetitive: your 'why' repeats the same words. Articulate distinct reasoning.");
+        }
+    }
+    const whoAllWords = whoLower.split(/\s+/).filter((w) => w.length > 2);
+    if (whoAllWords.length >= 5) {
+        const whoUniqueWords = new Set(whoAllWords);
+        if (whoUniqueWords.size / whoAllWords.length < 0.4) {
+            score -= 25;
+            feedback.push("Repetitive: your 'who' repeats the same words. Name a real audience.");
+        }
+    }
+    // ── Check 7: Buzzword-heavy corporate-speak ──────────────────────────
+    const buzzwords = [
+        "leverage", "synergies", "synergy", "paradigm", "holistic", "alignment",
+        "transformation", "innovative", "disruptive", "best practices",
+        "streamline", "ecosystem", "actionable", "circle back",
+    ];
+    const allText = `${whyLower} ${whoLower}`;
+    const buzzCount = buzzwords.filter((b) => allText.includes(b)).length;
+    if (buzzCount >= 4) {
+        score -= 35;
+        feedback.push("Buzzword-heavy: corporate-speak without concrete meaning. What specific problem does this solve?");
+    }
+    else if (buzzCount >= 3) {
+        score -= 30;
+        feedback.push("Buzzword-heavy: corporate-speak without concrete meaning. What specific problem does this solve?");
+    }
+    else if (buzzCount >= 2) {
+        score -= 20;
+        feedback.push("Buzzword-heavy: corporate-speak without concrete meaning. What specific problem does this solve?");
+    }
+    // ── Check 8: Hedging language — signals unclear value ─────────────────
+    const hedgeWords = ["could", "potentially", "maybe", "possibly", "might", "perhaps", "hopefully"];
+    const hedgeCount = hedgeWords.filter((h) => {
+        const regex = new RegExp(`\\b${h}\\b`, "i");
+        return regex.test(whyLower);
+    }).length;
+    if (hedgeCount >= 2) {
+        score -= 15;
+        feedback.push("Hedging: too many 'could/maybe/potentially' signals uncertain value. What WILL this achieve?");
+    }
+    // ── Check 9: Task-word echo — same word from task repeated 3+ times in why
+    for (const tw of taskWords) {
+        const twCount = whyWords.filter((w) => w === tw).length;
+        if (twCount >= 3) {
+            score -= 20;
+            feedback.push(`Echo: "${tw}" appears ${twCount} times in your 'why' — this is filler, not reasoning.`);
+            break; // one echo penalty max
+        }
+    }
+    // ── Check 10: Bonus for specificity ───────────────────────────────────
+    if (input.success_looks_like && input.success_looks_like.length > 20) {
+        score += 10;
+        feedback.push("Good: you defined what success looks like — this makes verification concrete.");
+    }
+    if (input.simplest_version && input.simplest_version.length > 20) {
+        score += 10;
+        feedback.push("Good: you identified the simplest version — this guards against over-engineering.");
+    }
+    // Clamp
+    score = Math.max(0, Math.min(100, score));
+    // Verdict
+    let verdict;
+    if (score >= 70) {
+        verdict = "proceed";
+        if (feedback.length === 0) {
+            feedback.push("Strong intentionality. Purpose and audience are clear — proceed with confidence.");
+        }
+    }
+    else if (score >= 40) {
+        verdict = "reconsider";
+        feedback.push("Pause and sharpen your thinking before writing code. Re-run critter_check once you have clearer answers.");
+    }
+    else {
+        verdict = "stop";
+        feedback.push("Stop: the purpose is unclear. Do not proceed until you can articulate WHY and WHO clearly.");
+    }
+    return { score, verdict, feedback, id: genId("crit") };
+}
+// ── Tool definition ─────────────────────────────────────────────────────────
+export const critterTools = [
+    {
+        name: "critter_check",
+        description: "The accountability partner that wants to know everything — answer 'Why are you doing this? Who is it for?' before starting work. " +
+            "Scores your answers for circular reasoning, vague audiences, and deference-over-understanding. " +
+            "Returns a go/no-go verdict. The friction is the feature: slowing down to think prevents scope creep and aimless work. " +
+            "Call this at the start of any non-trivial task.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                task: {
+                    type: "string",
+                    description: "What you are about to do (the action, not the goal)",
+                },
+                why: {
+                    type: "string",
+                    description: "Why are you doing this? Explain the purpose, not just the instruction. Avoid restating the task.",
+                },
+                who: {
+                    type: "string",
+                    description: "Who is this for? Name a specific role, persona, or person — not 'users' or 'everyone'.",
+                },
+                success_looks_like: {
+                    type: "string",
+                    description: "Optional: What does success look like? How will you know this worked?",
+                },
+                simplest_version: {
+                    type: "string",
+                    description: "Optional: What is the simplest version that still delivers value?",
+                },
+            },
+            required: ["task", "why", "who"],
+        },
+        handler: async (args) => {
+            ensureCritterTable();
+            const result = scoreCritterCheck(args);
+            // Persist for accountability
+            const db = getDb();
+            db.prepare(`INSERT INTO critter_checks (id, task, why, who, success_looks_like, simplest_version, score, verdict, feedback)
+         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(result.id, args.task, args.why, args.who, args.success_looks_like ?? null, args.simplest_version ?? null, result.score, result.verdict, JSON.stringify(result.feedback));
+            return {
+                id: result.id,
+                score: result.score,
+                verdict: result.verdict,
+                feedback: result.feedback,
+                tip: result.verdict === "proceed"
+                    ? "You've passed the critter check. Proceed with clear intent."
+                    : "Sharpen your answers and re-run critter_check before proceeding.",
+            };
+        },
+    },
+];
+//# sourceMappingURL=critterTools.js.map

package/dist/tools/critterTools.js.map

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