nodebench-mcp 2.28.0 → 2.31.0

package/dist/tools/contextTools.js

@@ -0,0 +1,175 @@
+/**
+ * Engine Context Tools — MCP tools for querying accumulated engine knowledge.
+ *
+ * 4 tools in the `engine_context` domain:
+ * - get_engine_context_health: Overall health of accumulated knowledge
+ * - get_workflow_history: Past runs with scores for a given workflow
+ * - archive_content: Save content to archive (prevents repetition)
+ * - search_content_archive: FTS5 search past content by theme/title
+ */
+import { getContextHealth, getWorkflowHistory, archiveContent, searchContentArchive, } from "../engine/contextBridge.js";
+export const contextTools = [
+    // ── get_engine_context_health ──────────────────────────────────────
+    {
+        name: "get_engine_context_health",
+        description: "Returns accumulated knowledge health: learnings count + freshness, conformance trend direction (improving/stable/regressing), recent run scores, content archive size, and workflow coverage. Use to understand how much context the engine has built up over time.",
+        inputSchema: {
+            type: "object",
+            properties: {},
+        },
+        handler: async () => {
+            try {
+                const health = getContextHealth();
+                return {
+                    ...health,
+                    _hint: health.learningsCount === 0
+                        ? "No learnings recorded yet. Run workflows via the engine to accumulate context."
+                        : `${health.learningsCount} learnings accumulated. Trend: ${health.trendDirection}.`,
+                };
+            }
+            catch (err) {
+                return { error: err.message ?? String(err), _hint: "Context tables may not exist yet. Start the engine to initialize." };
+            }
+        },
+    },
+    // ── get_workflow_history ───────────────────────────────────────────
+    {
+        name: "get_workflow_history",
+        description: "Returns past runs for a specific workflow with scores, grades, step counts, and durations. Use to track conformance improvements over time and identify regression patterns.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                workflow: {
+                    type: "string",
+                    description: "Workflow name (e.g., 'content_pipeline', 'fix_bug', 'new_feature')",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max results to return (default: 10)",
+                },
+            },
+            required: ["workflow"],
+        },
+        handler: async (args) => {
+            const workflow = String(args.workflow ?? "");
+            if (!workflow)
+                return { error: "workflow is required" };
+            const limit = typeof args.limit === "number" ? args.limit : 10;
+            try {
+                const history = getWorkflowHistory(workflow, limit);
+                return {
+                    workflow,
+                    runs: history,
+                    totalRuns: history.length,
+                    _hint: history.length === 0
+                        ? `No runs found for "${workflow}". Run this workflow via the engine API to start tracking.`
+                        : `${history.length} runs found. Latest score: ${history[0].score} (${history[0].grade}).`,
+                };
+            }
+            catch (err) {
+                return { error: err.message ?? String(err) };
+            }
+        },
+    },
+    // ── archive_content ───────────────────────────────────────────────
+    {
+        name: "archive_content",
+        description: "Save generated content to the archive for deduplication and theme tracking. Prevents the engine from regenerating similar content. Supports digest, post, report, and brief content types.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                title: {
+                    type: "string",
+                    description: "Content title",
+                },
+                content_type: {
+                    type: "string",
+                    enum: ["digest", "post", "report", "brief"],
+                    description: "Type of content",
+                },
+                digest: {
+                    type: "string",
+                    description: "Short summary/digest of the content",
+                },
+                themes: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "Themes/topics covered (for deduplication)",
+                },
+                workflow: {
+                    type: "string",
+                    description: "Workflow that generated this content (optional)",
+                },
+                full_content: {
+                    type: "string",
+                    description: "Full content body (optional, for storage)",
+                },
+            },
+            required: ["title", "content_type", "digest", "themes"],
+        },
+        handler: async (args) => {
+            const title = String(args.title ?? "");
+            const contentType = String(args.content_type ?? "");
+            const digest = String(args.digest ?? "");
+            const themes = Array.isArray(args.themes) ? args.themes.map(String) : [];
+            if (!title || !contentType || !digest) {
+                return { error: "title, content_type, and digest are required" };
+            }
+            try {
+                archiveContent(title, contentType, digest, themes, args.workflow ? String(args.workflow) : undefined, args.full_content ? String(args.full_content) : undefined);
+                return {
+                    archived: true,
+                    title,
+                    contentType,
+                    themeCount: themes.length,
+                    _hint: "Content archived. Future workflows will see these themes to avoid repetition.",
+                };
+            }
+            catch (err) {
+                return { error: err.message ?? String(err) };
+            }
+        },
+    },
+    // ── search_content_archive ────────────────────────────────────────
+    {
+        name: "search_content_archive",
+        description: "Search past content by theme, title, or keywords using FTS5 full-text search. Use before generating new content to check what's already been covered and avoid repetition.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                query: {
+                    type: "string",
+                    description: "Search query (FTS5 syntax supported, or plain keywords)",
+                },
+                content_type: {
+                    type: "string",
+                    enum: ["digest", "post", "report", "brief"],
+                    description: "Filter by content type (optional)",
+                },
+                limit: {
+                    type: "number",
+                    description: "Max results (default: 10)",
+                },
+            },
+        },
+        handler: async (args) => {
+            const query = String(args.query ?? "");
+            const contentType = args.content_type ? String(args.content_type) : undefined;
+            const limit = typeof args.limit === "number" ? args.limit : 10;
+            try {
+                const results = searchContentArchive(query, contentType, limit);
+                return {
+                    results,
+                    totalFound: results.length,
+                    _hint: results.length === 0
+                        ? "No matching content found. This topic hasn't been covered yet."
+                        : `Found ${results.length} matching items. Check themes to avoid overlap.`,
+                };
+            }
+            catch (err) {
+                return { error: err.message ?? String(err) };
+            }
+        },
+    },
+];
+//# sourceMappingURL=contextTools.js.map

package/dist/tools/contextTools.js.map

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

package/dist/tools/designGovernanceTools.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Design Governance Tools — Automated design spec enforcement for MCP agents.
+ *
+ * Provides three tools for agents to query the design system spec, check
+ * individual files for compliance, and scan an entire src/ tree for violations.
+ *
+ * Patterns are inlined (not imported from the frontend src/ directory) because
+ * this is a CommonJS-ish Node.js MCP server that can't reach into the
+ * frontend build.  The canonical source of truth is:
+ *   - src/design-governance/defaultSpec.ts
+ *   - scripts/ui/designLinter.mjs
+ * Keep this file in sync when updating banned patterns.
+ *
+ * 3 tools:
+ * - get_design_spec: Return the full governance spec as structured JSON
+ * - check_design_compliance: Lint a single file for violations
+ * - get_design_violations: Scan entire src/ tree, grouped + sorted
+ */
+import type { McpTool } from "../types.js";
+export declare const designGovernanceTools: McpTool[];