genat-mcp 2.2.1 → 2.2.3

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
@@ -110,7 +128,7 @@ If the global binary is not on PATH, use the full path, e.g. `node $(npm root -g
 ## Requirements
 
 - **Node.js** 20+
-- **n8n** with the [GenAT workflow](../workflows/genat-accessibility-tests-with-login.json) imported and activated (webhook path `webhook-test/webhook-genat-login`)
+- **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.
 - **DOM Analyzer** and **Accessibility Analyzer** services running (see main README: `npm run services` from repo root)
 
 ## Standalone script: run-genat.mjs
@@ -134,7 +152,7 @@ N8N_WEBHOOK_URL='https://your-n8n/webhook-test/webhook-genat-login' N8N_INSECURE
 N8N_MAX_ASSERTIONS=30 N8N_SCOPE_TO_REGIONS=header,main N8N_ANALYZE_STATES=1 node node_modules/genat-mcp/run-genat.mjs https://example.com .
 ```
 
-**Important:** Use `webhook-genat-login` (not `webhook-genat`). Import and activate [genat-accessibility-tests-with-login.json](../workflows/genat-accessibility-tests-with-login.json) in n8n.
+**Important:** Use `webhook-genat-login` or `webhook-genat-login-jira` (not `webhook-genat`). For JIRA support, import and activate [genat-accessibility-tests-with-login-jira.json](../workflows/genat-accessibility-tests-with-login-jira.json) and set N8N_WEBHOOK_URL to its webhook URL.
 
 **Optional – Cursor rule:** Copy the rule so the AI uses the correct webhook when creating workarounds (the MCP error responses also include this hint):
 ```bash
@@ -168,6 +186,7 @@ When creating run-genat.mjs: Use webhook-genat-login, NOT webhook-genat. Prefer
 - **loginUsername** (string, optional): Login username. Overrides .env when provided. Requires loginPassword.
 - **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.
 
 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.
 
@@ -177,6 +196,8 @@ Generated tests include keyboard accessibility checks (Tab order, focus) by defa
 
 ## Sample prompts
 
+See [prompts.md](prompts.md) for a full list of prompts including specific parent folders, login, JIRA, and combined options.
+
 **With login credentials in the prompt:**
 
 ```
@@ -197,6 +218,16 @@ Use GenAT for https://myapp.example.com/dashboard. Credentials are in .env.
 Use GenAT to generate accessibility tests for https://myapp.example.com/dashboard using this project folder: . Write the files to the project.
 ```
 
+**With JIRA acceptance criteria:**
+
+```
+Use GenAT for https://myapp.example.com/dashboard with jiraNumber PROJ-123. Write the files to the project.
+```
+
+```
+Generate accessibility tests for https://example.com using JIRA ticket A11Y-456. Use parentProjectFolder . and writeToProject true.
+```
+
 ## Publishing to npm
 
 Until the package is published, `npm install genat-mcp` returns 404. To publish:

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.1',
+    version: '2.2.3',
   },
   {
     capabilities: {
@@ -69,7 +70,7 @@ server.registerTool(
       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()
@@ -98,9 +99,13 @@ server.registerTool(
         .string()
         .optional()
         .describe('Login page URL if different from target URL'),
+      jiraNumber: z
+        .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".'),
     },
   },
-  async ({ url, parentProjectFolder, writeToProject, maxAssertions, scopeToRegions, analyzeStates, loginUsername, loginPassword, loginUrl }) => {
+  async ({ url, parentProjectFolder, writeToProject, maxAssertions, scopeToRegions, analyzeStates, loginUsername, loginPassword, loginUrl, jiraNumber }) => {
     if (!url || typeof url !== 'string') {
       return {
         content: [{ type: 'text', text: JSON.stringify({ error: 'Missing or invalid "url"' }) }],
@@ -108,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: [
@@ -129,7 +137,7 @@ server.registerTool(
 
     let login = {};
     try {
-      login = detectLogin(parentProjectFolder || '.') || {};
+      login = detectLogin(resolvedPath) || {};
     } catch (_) {}
 
     // Tool params override .env
@@ -159,6 +167,7 @@ server.registerTool(
         ...(login.passwordSelector && { loginPasswordSelector: login.passwordSelector }),
         ...(login.submitSelector && { loginSubmitSelector: login.submitSelector }),
       }),
+      ...(jiraNumber && jiraNumber.trim() && { jiraNumber: jiraNumber.trim() }),
     };
 
     const useInsecureTls = N8N_INSECURE_TLS && N8N_WEBHOOK_URL.startsWith('https://');
@@ -221,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.1",
+  "version": "2.2.3",
   "mcpName": "io.github.asokans@oclc.org/genat",
   "description": "MCP server GenAT: generate accessibility tests via n8n workflow (url + project folder)",
   "type": "module",