QAFusionX

Последовательный MCP QA-агент. Когда этот сервер подключён в Cursor, он блокирует режим Ask, задаёт два обязательных вопроса, а затем проходит 15-шаговый рабочий процесс, который нельзя пропустить. Завершение шага N записывает отметку в step-by-step/ — эта отметка единственный способ разблокировать шаг N+1.

Консоль управления — это живой GUI для того же движка: нумерованный конвейер, баннер режима Ask, браузер артефактов и консоль тестового запуска, за которой можно наблюдать.

ЗАБЛОКИРОВАНО — видимый браузер на устройстве каждого пользователя. Рабочий процесс — это конвейер, но краулинг и GUI-тесты никогда не выполняются как фоновая задача внутри него. Когда любой пользователь запускает QAFusionX на своей машине, на этом устройстве открывается отдельное окно браузера, показывающее каждый экран, всплывающее окно и клик. Headless отклоняется. Тихого режима не существует.

Что он делает

1. Ask — проект и цель (режим Ask) — название продукта, что тестировать, живой URL, скриншот.

2. Ask — пользовательские истории (режим Ask, обязательно) — zip / файлы, ссылка Jira или генерация из системы.

3. Сохранить User stories/ и General/01-target.md.

4. Краулинг раунда 1 — каждый экран и всплывающее окно: захват → анализ → справочный MD → живой план → следующий клик.

5. Заморозить план / задачи раунда 1.

6. Краулинг раунда 2 — та же структура каталогов, поиск всего, что пропустил раунд 1.

7. Генерация пользовательских историй — только если ответ на вопрос 2 был «generate-from-system». После раунда 2 создайте GeneratedUser stories/ из каждого захваченного потока. Последующие тесты используют только этот набор. Запуски через zip/Jira помечают этот шаг как N/A.

8. Полная карта системы — длинный, исчерпывающий markdown (короткие файлы отклоняются).

9. Ручные тест-кейсы в функциональном формате Jira в каталоге testCase Human/.

10. Загрузить эти кейсы в Jira (или записать офлайн-пейлоады).

11. Конвертировать 1:1 в YAML в testc2ai/.

12. Сгенерировать GUI и API Playwright-скрипты в AutomatedScripts/.

13. Запустить набор тестов в видимом браузере с интерфейсом (вы наблюдаете за каждым кликом), результаты также транслируются в GUI.

14. Экспортировать сбои в reports/QAFusionX-Issues.xlsx + .csv с доказательствами.

15. Создать баг-тикеты в Jira: тема, предусловие, шаги, ожидаемый результат, фактический результат, доказательство.

Related MCP server: mcp-playwright-test

Локальный запуск

npm install
npx playwright install chromium
cd console && npm install && cd ..
cp .env.example .env   # optional Jira credentials
npm run dev

• Консоль управления: http://127.0.0.1:43181

• API движка: http://127.0.0.1:43180

• Пример приложения под тестом: http://127.0.0.1:43181/sample/login
  Демо-логин: qa.analyst / FusionX@2026

Нажмите Run guided demo на консоли, чтобы выполнить каждый шаг на встроенном примере Intermediary Management (поля Emergency Details, соответствующие функциональному кейсу Jira).

Только MCP:

npx tsx src/index.ts

Подключение QAFusionX к Cursor (каждый проект, каждый чат)

Windows — полная установка TBB + mesh (рекомендуется):

git clone https://github.com/thejanaloit/QAFusionX.git $env:USERPROFILE\QAFusionX
cd $env:USERPROFILE\QAFusionX
npm run install:mesh
# or: powershell -ExecutionPolicy Bypass -File .\scripts\install-full-mesh.ps1

Это автоматически связывает и выполняет начальную настройку (клонирование + npm install, если отсутствует):

Конфигурация находится в config/tbb-mesh.json. Переопределите корневые каталоги с помощью переменных окружения (THEJA_BACKBONE_ROOT и т. д.) перед установкой.

macOS / Linux:

git clone https://github.com/thejanaloit/QAFusionX.git ~/QAFusionX
cd ~/QAFusionX
npm install --omit=dev
python3 scripts/link-tbb-mesh.py
bash scripts/install-global-cursor.sh

Это записывает пользовательскую конфигурацию (~/.cursor/mcp.json) и пользовательские правила (~/.cursor/rules/qafusionx.mdc, qafusionx-visible-browser.mdc). Cursor объединяет это в каждое рабочее пространство и каждый чат Agent/Ask. Затем:

1. Палитра команд → Developer: Reload Window

2. Настройки → Tools & MCP → включите QAFusionX (зелёный)

Этот репозиторий также содержит .cursor/mcp.json, поэтому достаточно просто открыть папку QAFusionX. Глобальным его делает установщик.

При первом использовании агент обязан:

1. Переключиться в режим Ask.

2. Спросить, что за проект и что тестировать (URL + скриншот).

3. Запросить пользовательские истории (zip, Jira или генерация). Этот второй вопрос обязателен.

Пока оба ответа не сохранены, каждый последующий инструмент возвращает BLOCKED.

Публикация на GitHub

Облачный агент, создавший этот проект, не имеет логина GitHub, поэтому не может создать github.com/<you>/QAFusionX отсюда. Исходный код уже находится на удалённом репозитории Cursor Origin. На вашей машине после gh auth login:

bash scripts/publish-github.sh QAFusionX public

Это создаёт репозиторий GitHub, добавляет удалённый репозиторий github и отправляет ветку main.

Источники пользовательских историй

Структура артефактов

artifacts/
  step-by-step/                 ticks — the only unlock
  User stories/                 zip / Jira stories
  GeneratedUser stories/        method 3 only, after Round 2
  General/                      01-target.md, human-qa-research.md
  Screens/
    round one/screenshots|references|plan/
    round two/screenshots|references|plan/
    complete-system-map.md
  testCase Human/               Jira-shaped markdown + json
  testc2ai/                     YAML for the AI runner
  AutomatedScripts/gui|api
  reports/                      suite results, XLSX/CSV, proof
  jira/                         upload log, payloads, created keys
  bugs/                         bug tickets with proof

Формат ручного тест-кейса

Заголовки следуют функциональному шаблону Jira:

[Sales & Marketing Module] [Intermediary Management][Add new/Manage][FP] - Validate that the Emergency Details section displays all required fields.

Обязательные разделы: Affects versions, Labels, Test Case Type, Priority, Parent, Linked work items, Preconditions, Test Steps, Test Comments, Expected Result, Actual Result.

Jira

Установите JIRA_BASE_URL, JIRA_EMAIL, JIRA_API_TOKEN, JIRA_PROJECT_KEY. Без них QAFusionX всё равно выполняет шаги, записывая jira/payloads/*.json — он никогда не пропускает узел.

Видимый браузер (ЗАБЛОКИРОВАНО)

Это правило заблокировано в движке, протоколе MCP и правилах Cursor. Вы не можете его отключить.

Конвейер по-прежнему выполняется шаг за шагом. Это не означает, что раунд 1, раунд 2 или GUI-тесты выполняются в фоновом режиме.

Когда QAFusionX запускается на устройстве пользователя:

1. На этом устройстве открывается отдельное реальное окно браузера.

2. Краулинг и GUI-тесты выполняются в этом окне.

3. Пользователь наблюдает за каждой навигацией и кликом.

QAFUSIONX_HEADED=0 отклоняется. Если на машине нет дисплея, QAFusionX останавливается и сообщает, что нужно запустить его на собственном компьютере пользователя. Он не продолжит работу в headless-режиме.

Сингальский — как этим пользоваться

После подключения MCP QAFusionX в Cursor перейдите в режим Ask. Сначала спрашивается проект и что нужно тестировать, URL, скриншот. Затем обязательно запрашиваются пользовательские истории — zip, ссылка Jira или генерация из системы. Только после ответа на оба вопроса можно начать краулинг / генерацию тестов. Нельзя пропустить ни один шаг и перейти к следующему; отметка в step-by-step/ — это и есть разблокировка следующего шага.

Не делайте это так, как будто оно выполняется внутри какого-то конвейера. На устройстве каждого пользователя должно открываться отдельное окно браузера, и оно должно быть видимым. Headless заблокирован.