@wcagc/mcp - npm Package Compare versions

Comparing version 0.6.0 to 0.7.0

dist/server.js

@@ -9,3 +9,3 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 // test/version.test.ts fails the build if the two ever drift.
-export const VERSION = "0.6.0";
+export const VERSION = "0.7.0";
 /**
@@ -12,0 +12,0 @@ * One server, two transports (hosted Streamable HTTP + local stdio) share this — the tool

dist/tools/pro.js

@@ -101,2 +101,40 @@ import { z } from "zod";
 });
+const fixSchema = z.object({
+    id: z.string().uuid(),
+    siteId: z.string().uuid(),
+    ruleId: z.string(),
+    impact: z.string(),
+    rootCauseKey: z.string().nullish(),
+    componentLabel: z.string().nullish(),
+    status: z.string(),
+    verifiedScope: z.string().nullish(),
+    verifiedAt: z.string().nullish(),
+    verifiedPagesCount: z.number().nullish(),
+    nodesCountAtTracking: z.number().nullish(),
+    pagesCountAtTracking: z.number().nullish(),
+    verifiable: z.boolean(),
+});
+const fixVerificationSchema = z.object({
+    id: z.string().uuid(),
+    remediationItemId: z.string().uuid(),
+    siteId: z.string().uuid(),
+    status: z.string(),
+    outcome: z.string().nullish(),
+    source: z.string(),
+    scopeGranularity: z.string(),
+    rootCauseKey: z.string().nullish(),
+    pagesRequested: z.number(),
+    pagesScanned: z.number(),
+    pagesFailed: z.number(),
+    nodesFound: z.number().nullish(),
+    ruleNodesFound: z.number().nullish(),
+    pages: z.array(z.object({ url: z.string(), status: z.string(), nodesFound: z.number().nullish() })),
+    failureReasonCode: z.string().nullish(),
+    startedAt: z.string(),
+    finishedAt: z.string().nullish(),
+});
+const fixVerificationAcceptedSchema = z.object({
+    id: z.string().uuid(),
+    status: z.string(),
+});
 /**
@@ -337,2 +375,68 @@ * Reading back a record the account already owns. The domain is closed and enumerable — one id,
     });
+    server.registerTool("get_fixes", {
+        title: "List tracked fixes",
+        description: "Lists tracked remediation items for a registered site, including status and " +
+            "the scope of any automated verification proof. Pro+ (REMEDIATION_TRACKING).",
+        inputSchema: { siteHost: z.string().describe("The registered site's normalized host, as list_sites reports it.") },
+        outputSchema: { fixes: z.array(fixSchema), ...disclaimerShape },
+        annotations: { title: "List tracked fixes", ...READ_ONLY },
+    }, async ({ siteHost }, extra) => {
+        try {
+            const bearer = resolveBearer(extra);
+            const site = await resolveSite(bearer, siteHost);
+            const fixes = await apiJson(bearer, `/api/v1/sites/${site.id}/fixes`);
+            const text = fixes.length === 0 ? `No tracked fixes for ${siteHost}.` : fixes.map((fix) => `[${fix.status}] ${fix.ruleId} — ${fix.componentLabel ?? fix.rootCauseKey ?? fix.id}` +
+                (fix.verifiedScope ? `; automated proof scope: ${fix.verifiedScope}` : "")).join("\n");
+            return {
+                content: [{ type: "text", text: `${text}\n\n${COVERAGE_DISCLAIMER}` }],
+                structuredContent: withDisclaimer({ fixes }),
+            };
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    server.registerTool("verify_fix", {
+        title: "Verify a tracked fix",
+        description: "Queues a targeted automated re-check of representative pages for one tracked " +
+            "fix. This is not a full-site re-scan or a compliance guarantee. Pro+.",
+        inputSchema: { remediationItemId: z.string().uuid().describe("A fix id returned by get_fixes.") },
+        outputSchema: { verification: fixVerificationAcceptedSchema, pollWith: z.literal("get_fix_verification"), ...disclaimerShape },
+        annotations: { title: "Verify a tracked fix", ...QUEUES_WORK },
+    }, async ({ remediationItemId }, extra) => {
+        try {
+            const bearer = resolveBearer(extra);
+            const verification = await apiJson(bearer, `/api/v1/remediation-items/${remediationItemId}/verifications`, { method: "POST" });
+            const response = withDisclaimer({ verification, pollWith: "get_fix_verification" });
+            return {
+                content: [{ type: "text", text: `Targeted verification ${verification.id} queued. Call get_fix_verification to poll. ` +
+                            `This is not a whole-site result.\n\n${COVERAGE_DISCLAIMER}` }],
+                structuredContent: response,
+            };
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
+    server.registerTool("get_fix_verification", {
+        title: "Get fix verification",
+        description: "Polls a targeted fix verification and reports only what was detected on the " +
+            "selected pages checked. Pro+.",
+        inputSchema: { fixVerificationId: z.string().uuid().describe("The id returned by verify_fix.") },
+        outputSchema: { verification: fixVerificationSchema, ...disclaimerShape },
+        annotations: { title: "Get fix verification", ...READ_ONLY },
+    }, async ({ fixVerificationId }, extra) => {
+        try {
+            const bearer = resolveBearer(extra);
+            const verification = await apiJson(bearer, `/api/v1/fix-verifications/${fixVerificationId}`);
+            const summary = summarizeFixVerification(verification);
+            return {
+                content: [{ type: "text", text: `${summary}\n\n${COVERAGE_DISCLAIMER}` }],
+                structuredContent: withDisclaimer({ verification }),
+            };
+        }
+        catch (err) {
+            return toolError(err);
+        }
+    });
 }
@@ -354,1 +458,21 @@ function summarizeJourneyRun(run) {
 }
+function summarizeFixVerification(verification) {
+    if (verification.status === "QUEUED" || verification.status === "RUNNING") {
+        return `Targeted verification ${verification.id} is ${verification.status.toLowerCase()}: ` +
+            `${verification.pagesScanned} of ${verification.pagesRequested} selected page(s) checked.`;
+    }
+    if (verification.outcome === "NOT_DETECTED") {
+        return `The tracked pattern was not detected on ${verification.pagesScanned} selected page(s). ` +
+            "This does not establish a whole-site result.";
+    }
+    if (verification.outcome === "STILL_PRESENT") {
+        return `The tracked pattern is still detected: ${verification.nodesFound ?? 0} matching node(s) ` +
+            `on ${verification.pagesScanned} checked page(s).`;
+    }
+    if (verification.outcome === "INCONCLUSIVE") {
+        return `Verification was inconclusive: ${verification.pagesScanned} page(s) checked and ` +
+            `${verification.pagesFailed} page(s) failed.`;
+    }
+    return `Verification ended with status ${verification.status}` +
+        (verification.failureReasonCode ? ` (${verification.failureReasonCode}).` : ".");
+}

package.json

 {
   "name": "@wcagc/mcp",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "mcpName": "io.github.WCAG-Compliance/mcp",
@@ -5,0 +5,0 @@ "description": "wcagc MCP server \u2014 a thin, stateless adapter that translates MCP tool calls into wcagc-api HTTP calls. No database, no secrets beyond WCAGC_API_BASE_URL (+ WCAGC_MCP_KEY for local stdio mode). Open-source: this package holds no business logic or credentials of its own.",

No alert changes

Improved metrics

Total package byte prevSize

77103

8.74%

Lines of code

1471

9.21%

No dependency changes