@mcp-graph-workflow/mcp-graph 5.4.0 → 5.5.0

package/dist/mcp/tools/validate.js

@@ -0,0 +1,70 @@
+/**
+ * MCP Tool — validate
+ * Consolidated validation tool (task browser validation + AC quality check).
+ * Replaces separate validate_task and validate_ac tools.
+ */
+import { z } from "zod/v4";
+import { runValidation } from "../../core/capture/validate-runner.js";
+import { KnowledgeStore } from "../../core/store/knowledge-store.js";
+import { indexCapture } from "../../core/rag/capture-indexer.js";
+import { validateAcQuality } from "../../core/analyzer/ac-validator.js";
+import { logger } from "../../core/utils/logger.js";
+export function registerValidate(server, store) {
+    server.tool("validate", "Validate tasks: browser-based validation (task) or acceptance criteria quality check (ac)", {
+        action: z.enum(["task", "ac"]).describe("Action: 'task' for browser validation, 'ac' for AC quality check"),
+        // task params
+        url: z.string().url().optional().describe("URL to validate — required for action 'task'"),
+        compareUrl: z.string().url().optional().describe("Second URL for A/B comparison (task only)"),
+        selector: z.string().optional().describe("CSS selector to scope content extraction (task only)"),
+        // shared
+        nodeId: z.string().optional().describe("Graph node ID (task: associate validation; ac: validate specific node)"),
+        // ac params
+        all: z.boolean().optional().describe("Validate all nodes with AC (ac only, default: true if no nodeId)"),
+    }, async ({ action, url, compareUrl, selector, nodeId, all }) => {
+        logger.debug("tool:validate", { action, nodeId });
+        if (action === "task") {
+            if (!url) {
+                return {
+                    content: [{ type: "text", text: JSON.stringify({ error: "url is required for task action" }) }],
+                    isError: true,
+                };
+            }
+            const result = await runValidation(url, { compareUrl, selector });
+            // Index captured content into knowledge store
+            const knowledgeStore = new KnowledgeStore(store.getDb());
+            indexCapture(knowledgeStore, result.primary);
+            if (result.comparison) {
+                indexCapture(knowledgeStore, result.comparison);
+            }
+            const response = {
+                ok: true,
+                url,
+                wordCount: result.primary.wordCount,
+                title: result.primary.title,
+                timestamp: result.timestamp,
+            };
+            if (nodeId) {
+                response.nodeId = nodeId;
+            }
+            if (result.diff) {
+                response.comparison = {
+                    compareUrl,
+                    wordCountDelta: result.diff.wordCountDelta,
+                    lengthDelta: result.diff.lengthDelta,
+                };
+            }
+            logger.info("tool:validate:task:ok", { nodeId, url });
+            return {
+                content: [{ type: "text", text: JSON.stringify(response, null, 2) }],
+            };
+        }
+        // action === "ac"
+        const doc = store.toGraphDocument();
+        const report = validateAcQuality(doc, nodeId, all ?? !nodeId);
+        logger.info("tool:validate:ac:ok", { nodes: report.nodes.length, score: report.overallScore });
+        return {
+            content: [{ type: "text", text: JSON.stringify({ ok: true, ...report }, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=validate.js.map

package/dist/mcp/tools/validate.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcp-graph-workflow/mcp-graph",
-  "version": "5.4.0",
+  "version": "5.5.0",
   "description": "MCP local-first PRD to task graph — transforms text into executable structure",
   "type": "module",
   "main": "dist/index.js",