genat-mcp 2.2.2 → 2.2.4

package/README.md

@@ -38,6 +38,7 @@ npm install /path/to/n8n_playwright_tests/mcp-genat
 | **N8N_MAX_ASSERTIONS** | No       | (none)  | Override assertion count for complex pages (e.g. `25`). Used as default when the tool is invoked without `maxAssertions`; also used by run-genat.mjs. |
 | **N8N_SCOPE_TO_REGIONS** | No       | (none)  | Comma-separated regions to focus tests on (e.g. `header,main,table`). Used as default when the tool is invoked without `scopeToRegions`; also used by run-genat.mjs. |
 | **N8N_ANALYZE_STATES** | No       | (off)   | Set to `1`, `true`, or `yes` to analyze dropdown/combobox expanded states and include state-specific violations in generated tests. Used as default when the tool is invoked without `analyzeStates`; also used by run-genat.mjs. Increases analysis time. |
+| **GENAT_PROJECT_ROOT** | No       | (cwd)   | Base path for resolving `parentProjectFolder`. When set, `parentProjectFolder` is resolved relative to this path. Use when your project is outside the MCP's working directory. Example: if your pytest project is at `/Users/me/projects/ill_tests`, set `GENAT_PROJECT_ROOT=/Users/me/projects` and use `parentProjectFolder ill_tests` in the prompt. |
 
 ## Cursor MCP config
 
@@ -84,6 +85,23 @@ npm install /path/to/n8n_playwright_tests/mcp-genat
 }
 ```
 
+**With GENAT_PROJECT_ROOT** (when project is outside MCP working directory):
+
+```json
+{
+  "mcpServers": {
+    "GenAT": {
+      "command": "npx",
+      "args": ["genat-mcp"],
+      "env": {
+        "GENAT_PROJECT_ROOT": "/Users/me/projects"
+      }
+    }
+  }
+}
+```
+Then use `parentProjectFolder ill_tests` in the prompt to target `/Users/me/projects/ill_tests`.
+
 **With optional params for complex pages** (`N8N_MAX_ASSERTIONS`, `N8N_SCOPE_TO_REGIONS`, `N8N_ANALYZE_STATES`):
 
 ```json

package/index.js

@@ -5,6 +5,7 @@
  * Detects framework (language, BDD, Page Object), POSTs to n8n webhook, returns generated files.
  */
 import https from 'node:https';
+import path from 'node:path';
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
@@ -51,7 +52,7 @@ function insecureHttpsFetch(url, { method = 'GET', headers = {}, body }) {
 const server = new McpServer(
   {
     name: 'GenAT',
-    version: '2.2.2',
+    version: '2.2.4',
   },
   {
     capabilities: {
@@ -64,12 +65,12 @@ server.registerTool(
   'GenAT',
   {
     description:
-      'Generate accessibility tests for a URL based on the project folder. Analyzes the page (DOM + a11y), detects project framework (TypeScript, JavaScript, or Python, BDD, Page Object), and returns generated test files (feature, spec/step defs, page objects). Optionally write files to the project folder. On failure: run node node_modules/genat-mcp/run-genat.mjs (NOT run-genat.mjs in project root). Use webhook-genat-login in N8N_WEBHOOK_URL (never webhook-genat).',
+      'Generate accessibility tests for a URL based on the project folder. Analyzes the page (DOM + a11y), detects project framework (TypeScript, JavaScript, or Python, BDD, Page Object), and returns generated test files (feature, spec/step defs, page objects). Optionally write files to the project folder. IMPORTANT: When the user mentions a JIRA ticket (e.g. "JIRA RB-40039"), pass jiraNumber with the key only (e.g. RB-40039) so the workflow can fetch acceptance criteria. On failure: run node node_modules/genat-mcp/run-genat.mjs (NOT run-genat.mjs in project root). Use webhook-genat-login in N8N_WEBHOOK_URL (never webhook-genat).',
     inputSchema: {
       url: z.string().describe('Page URL to analyze for accessibility (e.g. https://example.com)'),
       parentProjectFolder: z
         .string()
-        .describe('Absolute or relative path to the project root containing TypeScript, JavaScript, or Python Playwright code'),
+        .describe('Absolute or relative path to the project root. When GENAT_PROJECT_ROOT is set, resolved relative to it; otherwise relative to process.cwd().'),
       writeToProject: z
         .boolean()
         .optional()
@@ -101,7 +102,7 @@ server.registerTool(
       jiraNumber: z
         .string()
         .optional()
-        .describe('JIRA issue key (e.g. PROJ-123) for acceptance criteria'),
+        .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".'),
     },
   },
   async ({ url, parentProjectFolder, writeToProject, maxAssertions, scopeToRegions, analyzeStates, loginUsername, loginPassword, loginUrl, jiraNumber }) => {
@@ -112,9 +113,12 @@ server.registerTool(
       };
     }
 
+    const base = process.env.GENAT_PROJECT_ROOT || process.cwd();
+    const resolvedPath = path.resolve(base, parentProjectFolder || '.');
+
     let framework;
     try {
-      framework = detectFramework(parentProjectFolder || '.');
+      framework = detectFramework(resolvedPath);
     } catch (err) {
       return {
         content: [
@@ -133,7 +137,7 @@ server.registerTool(
 
     let login = {};
     try {
-      login = detectLogin(parentProjectFolder || '.') || {};
+      login = detectLogin(resolvedPath) || {};
     } catch (_) {}
 
     // Tool params override .env
@@ -226,9 +230,9 @@ server.registerTool(
       };
     }
 
-    if (writeToProject && parentProjectFolder && data) {
+    if (writeToProject && resolvedPath && data) {
       try {
-        const written = writeGeneratedFiles(parentProjectFolder, data);
+        const written = writeGeneratedFiles(resolvedPath, data);
         data._written = written;
       } catch (err) {
         data._writeError = err instanceof Error ? err.message : String(err);

package/package.json

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

package/rules/genat-mcp.mdc

@@ -27,3 +27,7 @@ Example:
 ```bash
 N8N_WEBHOOK_URL='https://your-n8n/webhook-test/webhook-genat-login' N8N_INSECURE_TLS=1 node node_modules/genat-mcp/run-genat.mjs https://example.com .
 ```
+
+## When invoking GenAT with JIRA
+
+When the user mentions a JIRA ticket in their prompt (e.g. "JIRA RB-40039", "JIRA ticket PROJ-123", "JIRA RB-40039"), **always pass `jiraNumber`** to the GenAT tool with the extracted key only (e.g. `RB-40039`, not "JIRA RB-40039"). The workflow uses this to fetch acceptance criteria. If you omit it, jiraNumber will be null and JIRA integration will not run.