genat-mcp 2.3.4 → 2.3.5

package/README.md

@@ -6,6 +6,10 @@ Full setup (n8n workflow, services, usage) is in the [project README](../README.
 
 **For teams:** See [GENAT_OVERVIEW.md](GENAT_OVERVIEW.md) for a concise, presentation-ready overview. Suitable as a source for NotebookLM or other AI tools to create slide decks.
 
+**Coverage claims:** Teams can copy [examples/coverage-manifest.example.yaml](examples/coverage-manifest.example.yaml) into their own repo (e.g. as `coverage-manifest.yaml`) and adjust it to document which standards, axe tags, workflows, and verification steps apply to their deployment. The manifest does not replace manual accessibility review; it aligns documented claims with the analyzer defaults and GenAT workflow behavior.
+
+**CI (Phase D):** The parent repo includes [scripts/ci/a11y-analyzer-scan.mjs](../scripts/ci/a11y-analyzer-scan.mjs) and a [GitHub Actions example](../templates/github-actions/a11y-analyzer-url.example.yml) to save analyzer JSON and gate on violation impact—useful even when GenAT is not invoked.
+
 ## Install
 
 **If the package is published to npm** (otherwise you get 404):
@@ -162,6 +166,7 @@ If the global binary is not on PATH, use the full path, e.g. `node $(npm root -g
 - **Node.js** 20+
 - **n8n** with a GenAT workflow imported and activated. Use [genat-accessibility-tests-with-login-jira.json](../workflows/genat-accessibility-tests-with-login-jira.json) (path `webhook-test/webhook-genat-login-jira`) for JIRA support, or [genat-accessibility-tests-with-login.json](../workflows/genat-accessibility-tests-with-login.json) (path `webhook-test/webhook-genat-login`). Set **N8N_WEBHOOK_URL** to the workflow's webhook URL.
 - **Optional v2 pipeline (Python / pytest-bdd quality):** Import [GenAT Accessibility Tests (with Login + JIRA) v2.json](../workflows/GenAT%20Accessibility%20Tests%20(with%20Login%20+%20JIRA)%20v2.json) and set **N8N_WEBHOOK_URL** to `…/webhook-test/webhook-genat-login-jira-v2`. v2 adds stricter pytest-bdd + Python rules (no nested markdown in code, layout hints, fixture-aware steps) and can run alongside the original workflow. The original v1 workflow is unchanged.
+- **Optional v3 pipeline (a11y contract validation):** Import [GenAT Accessibility Tests (with Login + JIRA) v3.json](../workflows/GenAT%20Accessibility%20Tests%20(with%20Login%20+%20JIRA)%20v3.json) and set **N8N_WEBHOOK_URL** to `…/webhook-test/webhook-genat-login-jira-v3`. Same as v2, plus a terminal **A11y contract validator** node that sets **`a11yContractOk`** (boolean) and **`a11yContractErrors`** (string[]) on the webhook JSON. The MCP also exposes **`_a11yContractOk`** / **`_a11yContractErrors`**. Optional JSON body **`failOnA11yContract`: true** fails the execution when the contract check fails (default is warn-only: still returns generated code). To rebuild v3 from an updated v2 in this repo, run `node scripts/build-genat-v3-workflow.mjs` from the **n8n_playwright_tests** root (regenerates **`webhookId`**; re-import or update the webhook in n8n if needed).
 - **DOM Analyzer** and **Accessibility Analyzer** services running (see main README: `npm run services` from repo root)
 
 ## Standalone script: run-genat.mjs
@@ -220,12 +225,13 @@ When creating run-genat.mjs: Use webhook-genat-login, NOT webhook-genat. Prefer
 - **loginPassword** (string, optional): Login password. Overrides .env when provided. Requires loginUsername.
 - **loginUrl** (string, optional): Login page URL if different from target URL.
 - **jiraNumber** (string, optional): JIRA issue key (e.g. PROJ-123). When provided, the workflow fetches the issue and injects acceptance criteria into the AI prompt.
+- **failOnA11yContract** (boolean, optional): When **N8N_WEBHOOK_URL** points at the **v3** JIRA workflow (`webhook-genat-login-jira-v3`), set `true` to make n8n error if the **A11y contract validator** fails (default is warn-only: JSON still returns generated files with `a11yContractOk` / `a11yContractErrors`).
 
 Login credentials: provide in the prompt (loginUsername, loginPassword) or in project `.env` (TEST_USER, TEST_PASSWORD, LOGIN_USER, LOGIN_PASSWORD). Tool params override .env. For sensitive environments, prefer .env (gitignored) since credentials in the prompt are visible in chat history.
 
 Framework detection: language (TypeScript vs JavaScript vs Python), BDD (Cucumber, pytest-bdd, Behave), and Page Object pattern (e.g. `pages/` directory or `*Page.ts`, `*Page.js`, `*_page.py` files). Returns JSON with `testCode`, `featureFile`, `stepDefCode`, `pageObjectCode` (and `_written` paths when writing).
 
-**Response fields for calling applications:** When `stepDefCode` is present, the MCP may set **`_stepDefIncomplete`** (boolean) and **`_stepDefIncompleteReason`** (string) using a lightweight heuristic (unclosed strings/delimiters, line continuation at EOF). Treat `true` as a signal to warn the user, retry generation, or block merge—do not assume the step file is runnable. Other optional fields from the workflow include **`usedLogin`** and **`loginReason`** when using login-capable workflows.
+**Response fields for calling applications:** When `stepDefCode` is present, the MCP may set **`_stepDefIncomplete`** (boolean) and **`_stepDefIncompleteReason`** (string) using a lightweight heuristic (unclosed strings/delimiters, line continuation at EOF). Treat `true` as a signal to warn the user, retry generation, or block merge—do not assume the step file is runnable. Other optional fields from the workflow include **`usedLogin`** and **`loginReason`** when using login-capable workflows. With the **v3** JIRA workflow, responses may include **`a11yContractOk`** / **`a11yContractErrors`** and mirrored **`_a11yContractOk`** / **`_a11yContractErrors`** (static checks for `withTags` / `AxeBuilder` on TS/JS and axe-playwright-python usage on Python).
 
 Generated tests include keyboard accessibility checks (Tab order, focus) by default. For complex pages, the workflow uses page complexity (regions, tables, widgets) to scale assertion count.
 

package/index.js

@@ -59,7 +59,7 @@ function insecureHttpsFetch(url, { method = 'GET', headers = {}, body, signal })
 const server = new McpServer(
   {
     name: 'GenAT',
-    version: '2.3.4',
+    version: '2.3.5',
   },
   {
     capabilities: {
@@ -122,6 +122,12 @@ server.registerTool(
         .string()
         .optional()
         .describe('JIRA issue key (e.g. PROJ-123, RB-40039). Extract from prompts like "JIRA RB-40039" or "JIRA ticket PROJ-123". Pass only the key (e.g. RB-40039), not "JIRA RB-40039".'),
+      failOnA11yContract: z
+        .boolean()
+        .optional()
+        .describe(
+          'v3 workflow only (webhook-genat-login-jira-v3): if true, n8n errors when static a11y contract checks fail on generated code. Default false: response still includes a11yContractOk / a11yContractErrors.'
+        ),
     },
   },
   async ({
@@ -137,6 +143,7 @@ server.registerTool(
     requiresAuth,
     forceLogin,
     jiraNumber,
+    failOnA11yContract,
   }) => {
     if (!url || typeof url !== 'string') {
       return {
@@ -205,6 +212,7 @@ server.registerTool(
       ...(requiresAuth === true && { requiresAuth: true }),
       ...(forceLogin === true && { forceLogin: true }),
       ...(jiraNumber && jiraNumber.trim() && { jiraNumber: jiraNumber.trim() }),
+      ...(failOnA11yContract === true && { failOnA11yContract: true }),
     };
 
     const useInsecureTls = N8N_INSECURE_TLS && N8N_WEBHOOK_URL.startsWith('https://');
@@ -290,6 +298,13 @@ server.registerTool(
       if (inc.reason) data._stepDefIncompleteReason = inc.reason;
     }
 
+    if (typeof data.a11yContractOk === 'boolean') {
+      data._a11yContractOk = data.a11yContractOk;
+    }
+    if (Array.isArray(data.a11yContractErrors)) {
+      data._a11yContractErrors = data.a11yContractErrors;
+    }
+
     if (writeToProject && resolvedPath && data) {
       if (data.bddFramework == null) data.bddFramework = framework.bddFramework;
       try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "genat-mcp",
-  "version": "2.3.4",
+  "version": "2.3.5",
   "mcpName": "io.github.asokans@oclc.org/genat",
   "description": "MCP server GenAT: generate accessibility tests via n8n workflow (url + project folder)",
   "type": "module",