nodebench-mcp 2.22.0 → 2.25.0

package/dist/tools/skillUpdateTools.js

@@ -0,0 +1,469 @@
+/**
+ * Skill Self-Update Protocol — Track rule/memory file provenance,
+ * detect staleness via source file hashing, and provide step-by-step
+ * resync procedures.
+ *
+ * A "skill" is any .md rule file (.windsurf/rules/, .cursor/rules/,
+ * AGENTS.md, etc.) that an agent uses. Each skill tracks:
+ * - Source documents: which files the skill was derived from
+ * - Update triggers: conditions that should prompt resyncing
+ * - Update instructions: step-by-step procedure to update the skill
+ * - Freshness signal: SHA-256 hash of source files + last sync date
+ *
+ * Frontmatter format injected into skill files:
+ * ---
+ * skill_id: convex-rules
+ * source_files: [convex/schema.ts, package.json]
+ * source_hash: abc123...
+ * last_synced: 2026-02-11T20:00:00Z
+ * update_triggers: [schema changes, new Convex version]
+ * update_instructions: [Read schema.ts, Check for new patterns, ...]
+ * ---
+ */
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { createHash } from "node:crypto";
+import { resolve } from "node:path";
+import { getDb, genId } from "../db.js";
+// ── Helpers ─────────────────────────────────────────────────────────
+/** Compute SHA-256 hash of file contents. Returns null if file missing. */
+function hashFile(filePath) {
+    try {
+        const content = readFileSync(filePath);
+        return createHash("sha256").update(content).digest("hex").slice(0, 16);
+    }
+    catch {
+        return null;
+    }
+}
+/** Compute composite hash of multiple source files (sorted, concatenated). */
+function computeSourceHash(sourceFiles, projectRoot) {
+    const fileHashes = {};
+    const parts = [];
+    for (const rel of [...sourceFiles].sort()) {
+        const abs = resolve(projectRoot, rel);
+        const h = hashFile(abs);
+        fileHashes[rel] = h;
+        parts.push(`${rel}:${h ?? "MISSING"}`);
+    }
+    const compositeHash = createHash("sha256")
+        .update(parts.join("|"))
+        .digest("hex")
+        .slice(0, 16);
+    return { compositeHash, fileHashes };
+}
+/** Parse YAML-like frontmatter from a markdown file. */
+function parseFrontmatter(content) {
+    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
+    if (!match)
+        return { frontmatter: {}, body: content };
+    const fm = {};
+    const lines = match[1].split(/\r?\n/);
+    for (const line of lines) {
+        const kv = line.match(/^(\w[\w_]*)\s*:\s*(.+)$/);
+        if (kv) {
+            const key = kv[1];
+            let val = kv[2].trim();
+            // Parse arrays: [a, b, c]
+            if (val.startsWith("[") && val.endsWith("]")) {
+                val = val.slice(1, -1).split(",").map((s) => s.trim()).filter(Boolean);
+            }
+            fm[key] = val;
+        }
+    }
+    return { frontmatter: fm, body: match[2] };
+}
+/** Serialize frontmatter back into a markdown file. */
+function serializeFrontmatter(fm, body) {
+    const lines = ["---"];
+    for (const [key, val] of Object.entries(fm)) {
+        if (Array.isArray(val)) {
+            lines.push(`${key}: [${val.join(", ")}]`);
+        }
+        else {
+            lines.push(`${key}: ${val}`);
+        }
+    }
+    lines.push("---");
+    return lines.join("\n") + "\n" + body;
+}
+/** Find which source files changed between two hashes. */
+function findChangedSources(oldHashes, newHashes) {
+    const changed = [];
+    for (const [file, newHash] of Object.entries(newHashes)) {
+        if (oldHashes[file] !== newHash) {
+            changed.push(file);
+        }
+    }
+    return changed;
+}
+// ── Tools ───────────────────────────────────────────────────────────
+export const skillUpdateTools = [
+    // ═══════════════════════════════════════════════════════════════════
+    // TOOL: register_skill
+    // ═══════════════════════════════════════════════════════════════════
+    {
+        name: "register_skill",
+        description: "Register a skill (rule/memory .md file) with its source documents, update triggers, " +
+            "and update instructions. Computes a SHA-256 hash of all source files for staleness " +
+            "detection. Injects freshness frontmatter into the skill file. Use this when creating " +
+            "or adopting a new rule file so it can be automatically checked for staleness.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                skillId: {
+                    type: "string",
+                    description: "Unique identifier for the skill (e.g. 'convex-rules', 'agents-md', 'nodebench-rules')",
+                },
+                name: {
+                    type: "string",
+                    description: "Human-readable name (e.g. 'Convex Guidelines')",
+                },
+                filePath: {
+                    type: "string",
+                    description: "Path to the skill .md file, relative to project root (e.g. '.windsurf/rules/convexRules.md')",
+                },
+                description: {
+                    type: "string",
+                    description: "What this skill covers",
+                },
+                sourceFiles: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Source files this skill was derived from (relative to project root). e.g. ['convex/schema.ts', 'package.json']",
+                },
+                updateTriggers: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Conditions that should prompt resyncing. e.g. ['schema.ts changes', 'New Convex version in package.json']",
+                },
+                updateInstructions: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Step-by-step procedure to update the skill when stale. e.g. ['Read schema.ts', 'Check for new patterns', 'Update examples']",
+                },
+                projectRoot: {
+                    type: "string",
+                    description: "Absolute path to the project root directory",
+                },
+                injectFrontmatter: {
+                    type: "boolean",
+                    description: "Whether to inject/update freshness frontmatter in the skill file (default: true)",
+                    default: true,
+                },
+            },
+            required: ["skillId", "name", "filePath", "sourceFiles", "projectRoot"],
+        },
+        handler: async (args) => {
+            const db = getDb();
+            const now = new Date().toISOString();
+            // Compute source hash
+            const { compositeHash, fileHashes } = computeSourceHash(args.sourceFiles, args.projectRoot);
+            const missingFiles = Object.entries(fileHashes)
+                .filter(([, h]) => h === null)
+                .map(([f]) => f);
+            // Upsert skill in DB
+            const id = genId("skill");
+            db.prepare(`
+        INSERT INTO skills (id, skill_id, name, file_path, description, source_files, source_hash, update_triggers, update_instructions, last_synced_at, status, metadata, created_at, updated_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'fresh', ?, ?, ?)
+        ON CONFLICT(skill_id) DO UPDATE SET
+          name = excluded.name,
+          file_path = excluded.file_path,
+          description = excluded.description,
+          source_files = excluded.source_files,
+          source_hash = excluded.source_hash,
+          update_triggers = excluded.update_triggers,
+          update_instructions = excluded.update_instructions,
+          last_synced_at = excluded.last_synced_at,
+          status = 'fresh',
+          metadata = excluded.metadata,
+          updated_at = excluded.updated_at
+      `).run(id, args.skillId, args.name, args.filePath, args.description ?? null, JSON.stringify(args.sourceFiles), compositeHash, JSON.stringify(args.updateTriggers ?? []), JSON.stringify(args.updateInstructions ?? []), now, JSON.stringify({ fileHashes }), now, now);
+            // Inject frontmatter into the skill file
+            if (args.injectFrontmatter !== false) {
+                const absPath = resolve(args.projectRoot, args.filePath);
+                if (existsSync(absPath)) {
+                    const raw = readFileSync(absPath, "utf-8");
+                    const { frontmatter: existingFm, body } = parseFrontmatter(raw);
+                    const newFm = {
+                        ...existingFm,
+                        skill_id: args.skillId,
+                        source_files: args.sourceFiles,
+                        source_hash: compositeHash,
+                        last_synced: now,
+                    };
+                    if (args.updateTriggers?.length) {
+                        newFm.update_triggers = args.updateTriggers;
+                    }
+                    if (args.updateInstructions?.length) {
+                        newFm.update_instructions = args.updateInstructions;
+                    }
+                    writeFileSync(absPath, serializeFrontmatter(newFm, body), "utf-8");
+                }
+            }
+            // Record initial sync in history
+            db.prepare(`
+        INSERT INTO skill_sync_history (id, skill_id, previous_hash, new_hash, changed_sources, trigger_reason, sync_notes, synced_at)
+        VALUES (?, ?, NULL, ?, ?, 'initial_registration', 'Skill registered', ?)
+      `).run(genId("sync"), args.skillId, compositeHash, JSON.stringify(args.sourceFiles), now);
+            return {
+                skillId: args.skillId,
+                name: args.name,
+                filePath: args.filePath,
+                sourceFiles: args.sourceFiles,
+                sourceHash: compositeHash,
+                missingFiles,
+                status: "fresh",
+                lastSyncedAt: now,
+                frontmatterInjected: args.injectFrontmatter !== false,
+                _hint: `Skill "${args.name}" registered with ${args.sourceFiles.length} source files. Hash: ${compositeHash}. Use check_skill_freshness to detect staleness.`,
+            };
+        },
+    },
+    // ═══════════════════════════════════════════════════════════════════
+    // TOOL: check_skill_freshness
+    // ═══════════════════════════════════════════════════════════════════
+    {
+        name: "check_skill_freshness",
+        description: "Check if registered skills are stale by comparing current source file hashes " +
+            "against stored hashes. Returns a freshness report for each skill, identifying " +
+            "which source files changed and which update triggers apply. Run this at the " +
+            "start of a session or after significant code changes.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                skillId: {
+                    type: "string",
+                    description: "Check a specific skill (optional — omit to check all)",
+                },
+                projectRoot: {
+                    type: "string",
+                    description: "Absolute path to the project root directory",
+                },
+                autoUpdateStatus: {
+                    type: "boolean",
+                    description: "Automatically update skill status in DB (default: true)",
+                    default: true,
+                },
+            },
+            required: ["projectRoot"],
+        },
+        handler: async (args) => {
+            const db = getDb();
+            const skills = args.skillId
+                ? db.prepare("SELECT * FROM skills WHERE skill_id = ?").all(args.skillId)
+                : db.prepare("SELECT * FROM skills ORDER BY skill_id").all();
+            if (!skills.length) {
+                return {
+                    count: 0,
+                    skills: [],
+                    _hint: args.skillId
+                        ? `No skill found with id "${args.skillId}". Use register_skill to register it.`
+                        : "No skills registered. Use register_skill to register your rule files.",
+                };
+            }
+            const report = [];
+            let staleCount = 0;
+            for (const skill of skills) {
+                const sourceFiles = JSON.parse(skill.source_files);
+                const storedHash = skill.source_hash;
+                const storedMeta = skill.metadata ? JSON.parse(skill.metadata) : {};
+                const storedFileHashes = storedMeta.fileHashes ?? {};
+                const { compositeHash, fileHashes } = computeSourceHash(sourceFiles, args.projectRoot);
+                const isStale = compositeHash !== storedHash;
+                const changedFiles = findChangedSources(storedFileHashes, fileHashes);
+                const triggers = JSON.parse(skill.update_triggers);
+                const instructions = JSON.parse(skill.update_instructions);
+                // Check which triggers apply based on changed files
+                const matchedTriggers = triggers.filter(t => {
+                    const tLower = t.toLowerCase();
+                    return changedFiles.some(f => tLower.includes(f.toLowerCase().split("/").pop().split(".")[0]));
+                });
+                if (isStale)
+                    staleCount++;
+                // Update DB status
+                if (args.autoUpdateStatus !== false && isStale) {
+                    db.prepare("UPDATE skills SET status = 'stale', updated_at = datetime('now') WHERE skill_id = ?")
+                        .run(skill.skill_id);
+                }
+                const lastSyncMs = skill.last_synced_at ? Date.now() - new Date(skill.last_synced_at).getTime() : null;
+                const daysSinceSync = lastSyncMs ? Math.floor(lastSyncMs / 86400000) : null;
+                report.push({
+                    skillId: skill.skill_id,
+                    name: skill.name,
+                    filePath: skill.file_path,
+                    status: isStale ? "stale" : "fresh",
+                    storedHash,
+                    currentHash: compositeHash,
+                    changedFiles,
+                    matchedTriggers,
+                    lastSyncedAt: skill.last_synced_at,
+                    daysSinceSync,
+                    sourceFileCount: sourceFiles.length,
+                    updateInstructions: isStale ? instructions : undefined,
+                });
+            }
+            return {
+                count: report.length,
+                staleCount,
+                freshCount: report.length - staleCount,
+                skills: report,
+                _hint: staleCount > 0
+                    ? `${staleCount} skill(s) are STALE and need resyncing. Use sync_skill({ skillId, projectRoot }) to update each one.`
+                    : "All skills are fresh — no updates needed.",
+            };
+        },
+    },
+    // ═══════════════════════════════════════════════════════════════════
+    // TOOL: sync_skill
+    // ═══════════════════════════════════════════════════════════════════
+    {
+        name: "sync_skill",
+        description: "Resync a stale skill after applying updates. Recomputes source hashes, updates " +
+            "the freshness frontmatter in the skill file, and records the sync in history. " +
+            "Call this AFTER you have followed the update_instructions and updated the skill " +
+            "file content. This tool just records that the sync happened.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                skillId: {
+                    type: "string",
+                    description: "The skill to mark as synced",
+                },
+                projectRoot: {
+                    type: "string",
+                    description: "Absolute path to the project root directory",
+                },
+                syncNotes: {
+                    type: "string",
+                    description: "What was updated in this sync (e.g. 'Added new table validators, updated function patterns')",
+                },
+                triggerReason: {
+                    type: "string",
+                    description: "What triggered this sync (e.g. 'schema.ts changed — new narrativeHypotheses table')",
+                },
+            },
+            required: ["skillId", "projectRoot"],
+        },
+        handler: async (args) => {
+            const db = getDb();
+            const now = new Date().toISOString();
+            const skill = db.prepare("SELECT * FROM skills WHERE skill_id = ?").get(args.skillId);
+            if (!skill)
+                throw new Error(`Skill "${args.skillId}" not found. Use register_skill first.`);
+            const sourceFiles = JSON.parse(skill.source_files);
+            const previousHash = skill.source_hash;
+            const previousMeta = skill.metadata ? JSON.parse(skill.metadata) : {};
+            const previousFileHashes = previousMeta.fileHashes ?? {};
+            // Recompute hash
+            const { compositeHash, fileHashes } = computeSourceHash(sourceFiles, args.projectRoot);
+            const changedFiles = findChangedSources(previousFileHashes, fileHashes);
+            // Update skill in DB
+            db.prepare(`
+        UPDATE skills SET
+          source_hash = ?,
+          last_synced_at = ?,
+          status = 'fresh',
+          metadata = ?,
+          updated_at = ?
+        WHERE skill_id = ?
+      `).run(compositeHash, now, JSON.stringify({ fileHashes }), now, args.skillId);
+            // Record in history
+            db.prepare(`
+        INSERT INTO skill_sync_history (id, skill_id, previous_hash, new_hash, changed_sources, trigger_reason, sync_notes, synced_at)
+        VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+      `).run(genId("sync"), args.skillId, previousHash, compositeHash, JSON.stringify(changedFiles), args.triggerReason ?? null, args.syncNotes ?? null, now);
+            // Update frontmatter in skill file
+            const absPath = resolve(args.projectRoot, skill.file_path);
+            if (existsSync(absPath)) {
+                const raw = readFileSync(absPath, "utf-8");
+                const { frontmatter: existingFm, body } = parseFrontmatter(raw);
+                existingFm.source_hash = compositeHash;
+                existingFm.last_synced = now;
+                writeFileSync(absPath, serializeFrontmatter(existingFm, body), "utf-8");
+            }
+            return {
+                skillId: args.skillId,
+                name: skill.name,
+                previousHash,
+                newHash: compositeHash,
+                changedFiles,
+                status: "fresh",
+                syncedAt: now,
+                triggerReason: args.triggerReason ?? null,
+                syncNotes: args.syncNotes ?? null,
+                _hint: `Skill "${skill.name}" synced. Hash: ${previousHash} → ${compositeHash}. ${changedFiles.length} source file(s) changed.`,
+            };
+        },
+    },
+    // ═══════════════════════════════════════════════════════════════════
+    // TOOL: list_skills
+    // ═══════════════════════════════════════════════════════════════════
+    {
+        name: "list_skills",
+        description: "List all registered skills with their freshness status, source files, " +
+            "update triggers, and sync history. Use to get an overview of all tracked " +
+            "rule/memory files and whether any need updating.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                status: {
+                    type: "string",
+                    enum: ["all", "fresh", "stale"],
+                    description: "Filter by status (default: all)",
+                },
+                includeHistory: {
+                    type: "boolean",
+                    description: "Include sync history for each skill (default: false)",
+                },
+            },
+        },
+        handler: async (args) => {
+            const db = getDb();
+            const filter = args.status && args.status !== "all" ? args.status : null;
+            const skills = filter
+                ? db.prepare("SELECT * FROM skills WHERE status = ? ORDER BY skill_id").all(filter)
+                : db.prepare("SELECT * FROM skills ORDER BY skill_id").all();
+            const result = skills.map(s => {
+                const entry = {
+                    skillId: s.skill_id,
+                    name: s.name,
+                    filePath: s.file_path,
+                    description: s.description,
+                    status: s.status,
+                    sourceFiles: JSON.parse(s.source_files),
+                    sourceHash: s.source_hash,
+                    updateTriggers: JSON.parse(s.update_triggers),
+                    updateInstructions: JSON.parse(s.update_instructions),
+                    lastSyncedAt: s.last_synced_at,
+                    createdAt: s.created_at,
+                };
+                if (args.includeHistory) {
+                    const history = db.prepare("SELECT * FROM skill_sync_history WHERE skill_id = ? ORDER BY synced_at DESC LIMIT 10").all(s.skill_id);
+                    entry.syncHistory = history.map(h => ({
+                        previousHash: h.previous_hash,
+                        newHash: h.new_hash,
+                        changedSources: h.changed_sources ? JSON.parse(h.changed_sources) : [],
+                        triggerReason: h.trigger_reason,
+                        syncNotes: h.sync_notes,
+                        syncedAt: h.synced_at,
+                    }));
+                }
+                return entry;
+            });
+            const staleCount = result.filter(s => s.status === "stale").length;
+            return {
+                count: result.length,
+                staleCount,
+                freshCount: result.length - staleCount,
+                skills: result,
+                _hint: staleCount > 0
+                    ? `${staleCount} skill(s) are stale. Run check_skill_freshness to see details, then sync_skill to update.`
+                    : result.length > 0
+                        ? "All skills are fresh."
+                        : "No skills registered. Use register_skill to start tracking your rule files.",
+            };
+        },
+    },
+];
+//# sourceMappingURL=skillUpdateTools.js.map

package/dist/tools/skillUpdateTools.js.map

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

package/dist/tools/toolRegistry.d.ts

@@ -12,8 +12,13 @@
 export interface ToolQuickRef {
     /** 1-2 sentence guidance on what to do after calling this tool */
     nextAction: string;
-    /** Tools commonly used after this one */
+    /** Tools commonly used after this one (workflow-sequential adjacency) */
     nextTools: string[];
+    /** Conceptually related tools — same problem domain but different workflow paths.
+     *  Unlike nextTools (sequential: "do X then Y"), relatedTools is associative:
+     *  "if you're doing X, you might also want Y". Auto-derived from category siblings,
+     *  domain clusters, and tag overlap. Enables multi-hop graph traversal. */
+    relatedTools?: string[];
     /** Which methodology to consult for full guidance */
     methodology?: string;
     /** Short tip for effective use */
@@ -33,6 +38,9 @@ export interface ToolRegistryEntry {
 export declare const TOOL_REGISTRY: Map<string, ToolRegistryEntry>;
 /** All registry entries as array */
 export declare const ALL_REGISTRY_ENTRIES: ToolRegistryEntry[];
+export declare function _setDomainClustersRef(clusters: Record<string, string[]>): void;
+/** Populate relatedTools for all registry entries. Called once at module load after DOMAIN_CLUSTERS exists. */
+export declare function _populateRelatedTools(): void;
 /** Get quick ref for a tool, with fallback for unregistered tools */
 export declare function getQuickRef(toolName: string): ToolQuickRef | null;
 /** Get all tools in a category */
@@ -51,6 +59,10 @@ export interface SearchResult {
     quickRef: ToolQuickRef;
     phase: string;
     tags: string[];
+    /** Depth at which this result was found (0 = direct match, 1+ = expansion hop) */
+    depth?: number;
+    /** Tools that led to this result being included via relatedTools expansion */
+    expandedFrom?: string[];
 }
 export type SearchMode = "hybrid" | "fuzzy" | "regex" | "prefix" | "semantic" | "exact" | "dense" | "embedding";
 /** Tokenize text into lowercase words (alpha + underscore only) */
@@ -108,6 +120,8 @@ export declare function hybridSearch(query: string, tools: Array<{
     /** If true, search ALL_REGISTRY_ENTRIES (full 175-tool registry) regardless of loaded preset.
      *  Needed for dynamic loading: discover_tools must find unloaded tools to suggest load_toolset. */
     searchFullRegistry?: boolean;
+    /** Number of results to skip for cursor-based pagination. Default: 0. */
+    offset?: number;
     /** Ablation flags: disable individual strategies to measure their contribution */
     ablation?: {
         disableSynonyms?: boolean;