qaa-agent 1.7.4 → 1.8.1

package/bin/install.cjs

@@ -1,212 +1,253 @@
-#!/usr/bin/env node
-/**
- * QAA - QA Automation Agent Installer
- * Run with: npx qaa-agent
- */
-
-const fs = require('fs');
-const path = require('path');
-const readline = require('readline');
-
-const VERSION = require('../package.json').version;
-const ROOT = path.resolve(__dirname, '..');
-const HOME = process.env.HOME || process.env.USERPROFILE;
-
-// Runtime configs
-const RUNTIMES = {
-  '1': { name: 'Claude Code', dir: path.join(HOME, '.claude') },
-  '2': { name: 'OpenCode', dir: path.join(HOME, '.config', 'opencode') },
-};
-
-function ask(question, defaultVal) {
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  return new Promise(resolve => {
-    rl.question(question, answer => {
-      rl.close();
-      resolve(answer.trim() || defaultVal);
-    });
-  });
-}
-
-function copyDir(src, dest) {
-  if (!fs.existsSync(src)) return 0;
-  fs.mkdirSync(dest, { recursive: true });
-  let count = 0;
-  for (const entry of fs.readdirSync(src, { withFileTypes: true })) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      count += copyDir(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-      count++;
-    }
-  }
-  return count;
-}
-
-function copyFile(src, dest) {
-  if (!fs.existsSync(src)) return false;
-  fs.mkdirSync(path.dirname(dest), { recursive: true });
-  fs.copyFileSync(src, dest);
-  return true;
-}
-
-function countEntries(dir, type) {
-  if (!fs.existsSync(dir)) return 0;
-  const entries = fs.readdirSync(dir, { withFileTypes: true });
-  if (type === 'dirs') return entries.filter(e => e.isDirectory()).length;
-  return entries.filter(e => e.isFile()).length;
-}
-
-function ok(msg) { console.log(`  \x1b[32m✓\x1b[0m ${msg}`); }
-function info(msg) { console.log(`  ${msg}`); }
-
-async function main() {
-  console.log('');
-  console.log('  \x1b[36m ██████╗  █████╗  █████╗ \x1b[0m');
-  console.log('  \x1b[36m██╔═══██╗██╔══██╗██╔══██╗\x1b[0m');
-  console.log('  \x1b[36m██║   ██║███████║███████║\x1b[0m');
-  console.log('  \x1b[36m██║▄▄ ██║██╔══██║██╔══██║\x1b[0m');
-  console.log('  \x1b[36m╚██████╔╝██║  ██║██║  ██║\x1b[0m');
-  console.log('  \x1b[36m ╚══▀▀═╝ ╚═╝  ╚═╝╚═╝  ╚═╝\x1b[0m');
-  console.log('');
-  console.log(`  \x1b[1mQA Automation Agent\x1b[0m v${VERSION}`);
-  console.log('  Multi-agent QA pipeline for Claude Code.');
-  console.log('  Analyzes repos, generates tests, validates, and creates PRs.');
-  console.log('');
-
-  // Ask runtime
-  console.log('  Which runtime would you like to install for?');
-  console.log('');
-  console.log('  1) Claude Code  (~/.claude)');
-  console.log('  2) OpenCode     (~/.config/opencode)');
-  console.log('');
-  const runtimeChoice = await ask('  Choice [1]: ', '1');
-  const runtime = RUNTIMES[runtimeChoice] || RUNTIMES['1'];
-
-  // Ask scope
-  console.log('');
-  console.log('  Where would you like to install?');
-  console.log('');
-  console.log(`  1) Global (~/${path.relative(HOME, runtime.dir)}) - available in all projects`);
-  console.log('  2) Local  (./.claude) - this project only');
-  console.log('');
-  const scopeChoice = await ask('  Choice [1]: ', '1');
-  const isGlobal = scopeChoice !== '2';
-  const baseDir = isGlobal ? runtime.dir : path.join(process.cwd(), '.claude');
-  const qaaDir = isGlobal ? path.join(runtime.dir, 'qaa') : path.join(process.cwd(), '.claude', 'qaa');
-
-  console.log('');
-  console.log(`  Installing for ${runtime.name} to ${isGlobal ? '~/' + path.relative(HOME, runtime.dir) : './.claude'}`);
-  console.log('');
-
-  // Install commands (from commands/ in package root to ~/.claude/commands/)
-  const commandsSrc = path.join(ROOT, 'commands');
-  const commandsDest = path.join(baseDir, 'commands');
-  const cmdCount = copyDir(commandsSrc, commandsDest);
-  ok(`Installed ${cmdCount} slash commands`);
-
-  // Install skills (from skills/ in package root to ~/.claude/skills/)
-  const skillsSrc = path.join(ROOT, 'skills');
-  const skillsDest = path.join(baseDir, 'skills');
-  const skillCount = copyDir(skillsSrc, skillsDest);
-  const skillDirCount = countEntries(skillsSrc, 'dirs');
-  ok(`Installed ${skillDirCount} skills (${skillCount} files)`);
-
-  // Install workflows
-  const workflowsSrc = path.join(ROOT, 'workflows');
-  const workflowsDest = path.join(qaaDir, 'workflows');
-  const wfCount = copyDir(workflowsSrc, workflowsDest);
-  ok(`Installed ${wfCount} workflows`);
-
-  // Install agents
-  const agentsSrc = path.join(ROOT, 'agents');
-  const agentsDest = path.join(qaaDir, 'agents');
-  const agentCount = copyDir(agentsSrc, agentsDest);
-  ok(`Installed ${agentCount} agent definitions`);
-
-  // Install templates
-  const templatesSrc = path.join(ROOT, 'templates');
-  const templatesDest = path.join(qaaDir, 'templates');
-  const templateCount = copyDir(templatesSrc, templatesDest);
-  ok(`Installed ${templateCount} templates`);
-
-  // Install bin
-  const binSrc = path.join(ROOT, 'bin');
-  const binDest = path.join(qaaDir, 'bin');
-  const binCount = copyDir(binSrc, binDest);
-  try { fs.unlinkSync(path.join(binDest, 'install.cjs')); } catch {}
-  ok(`Installed CLI tooling`);
-
-  // Install CLAUDE.md
-  copyFile(path.join(ROOT, 'CLAUDE.md'), path.join(qaaDir, 'CLAUDE.md'));
-  ok('Installed QA standards (CLAUDE.md)');
-
-  // Install .mcp.json (Playwright MCP server config)
-  const mcpSrc = path.join(ROOT, '.mcp.json');
-  if (fs.existsSync(mcpSrc)) {
-    // Copy to qaa dir for reference
-    copyFile(mcpSrc, path.join(qaaDir, '.mcp.json'));
-
-    // Merge MCP servers into ~/.claude.json (user-scope) so they're available in ALL projects
-    // Note: ~/.claude/.mcp.json is project-scope for ~/.claude/ only — NOT global
-    const userConfigPath = path.join(HOME, '.claude.json');
-    let userConfig = {};
-    if (fs.existsSync(userConfigPath)) {
-      try { userConfig = JSON.parse(fs.readFileSync(userConfigPath, 'utf8')); } catch {}
-    }
-    userConfig.mcpServers = userConfig.mcpServers || {};
-    const qaaMcp = JSON.parse(fs.readFileSync(mcpSrc, 'utf8'));
-    Object.assign(userConfig.mcpServers, qaaMcp.mcpServers);
-    fs.writeFileSync(userConfigPath, JSON.stringify(userConfig, null, 2));
-    ok('Installed Playwright MCP server config (user-scope — available in all projects)');
-  }
-
-  // Write version
-  fs.writeFileSync(path.join(qaaDir, 'VERSION'), VERSION);
-  ok(`Wrote VERSION (${VERSION})`);
-
-  // Merge settings (from settings.json in package root)
-  const settingsSrc = path.join(ROOT, 'settings.json');
-  const settingsDest = path.join(baseDir, 'settings.json');
-  if (fs.existsSync(settingsSrc)) {
-    let existing = {};
-    if (fs.existsSync(settingsDest)) {
-      try { existing = JSON.parse(fs.readFileSync(settingsDest, 'utf8')); } catch {}
-    }
-    const qaaSettings = JSON.parse(fs.readFileSync(settingsSrc, 'utf8'));
-    if (qaaSettings.permissions) {
-      existing.permissions = existing.permissions || {};
-      existing.permissions.allow = [...new Set([
-        ...(existing.permissions.allow || []),
-        ...(qaaSettings.permissions.allow || [])
-      ])];
-    }
-    fs.writeFileSync(settingsDest, JSON.stringify(existing, null, 2));
-    ok('Merged permissions into settings.json');
-  }
-
-  // Done
-  const total = cmdCount + skillCount + agentCount + templateCount + wfCount + binCount;
-  console.log('');
-  console.log(`  \x1b[32m✓ Done!\x1b[0m Installed ${total} files.`);
-  console.log('');
-  console.log('  Open Claude Code in any project and run:');
-  console.log('');
-  console.log('    \x1b[1m/qa-start\x1b[0m          Full QA pipeline (multi-agent)');
-  console.log('    \x1b[1m/qa-map\x1b[0m            Codebase map + analysis');
-  console.log('    \x1b[1m/qa-create-test\x1b[0m    Tests for a feature/ticket');
-  console.log('    \x1b[1m/qa-audit\x1b[0m          Audit existing tests');
-  console.log('    \x1b[1m/qa-fix\x1b[0m            Fix broken tests');
-  console.log('    \x1b[1m/qa-testid\x1b[0m         Inject data-testid attributes');
-  console.log('    \x1b[1m/qa-pr\x1b[0m             Create QA pull request');
-  console.log('');
-  console.log(`  ${cmdCount} commands + ${skillDirCount} skills + ${agentCount} agents ready.`);
-  console.log('');
-}
-
-main().catch(err => {
-  console.error('Installation failed:', err.message);
-  process.exit(1);
-});
+#!/usr/bin/env node
+
+/**
+ * QAA Agent Installer
+ *
+ * Installs QAA (QA Automation Agent) into the user's Claude Code environment.
+ *
+ * What it does:
+ *   1. Copies agents, commands, skills, templates, workflows, docs, bin, and config files
+ *      to the chosen install directory (global ~/.claude/qaa or local ./.claude/qaa)
+ *   2. Registers Playwright MCP and Context7 MCP as global MCP servers
+ *   3. Merges required permissions into Claude Code settings.json
+ *
+ * Usage:
+ *   npx qaa-agent
+ */
+
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+const { execSync } = require('child_process');
+
+// ── Helpers ──────────────────────────────────────────────────────────────────
+
+function log(msg) { console.log(`  ${msg}`); }
+function success(msg) { console.log(`  ✓ ${msg}`); }
+function warn(msg) { console.log(`  ⚠ ${msg}`); }
+function fail(msg) { console.error(`  ✗ ${msg}`); }
+
+function ask(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise(resolve => {
+    rl.question(`  ${question} `, answer => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+function copyDirRecursive(src, dest) {
+  if (!fs.existsSync(src)) return 0;
+  fs.mkdirSync(dest, { recursive: true });
+  let count = 0;
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+    if (entry.isDirectory()) {
+      count += copyDirRecursive(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+      count++;
+    }
+  }
+  return count;
+}
+
+function deepMerge(target, source) {
+  for (const key of Object.keys(source)) {
+    if (
+      source[key] && typeof source[key] === 'object' && !Array.isArray(source[key]) &&
+      target[key] && typeof target[key] === 'object' && !Array.isArray(target[key])
+    ) {
+      deepMerge(target[key], source[key]);
+    } else if (Array.isArray(source[key]) && Array.isArray(target[key])) {
+      // Merge arrays without duplicates
+      const merged = [...new Set([...target[key], ...source[key]])];
+      target[key] = merged;
+    } else {
+      target[key] = source[key];
+    }
+  }
+  return target;
+}
+
+// ── MCP Registration ─────────────────────────────────────────────────────────
+
+function registerMcpServers(claudeJsonPath) {
+  const mcpServers = {
+    playwright: {
+      command: 'npx',
+      args: ['@playwright/mcp@latest']
+    },
+    context7: {
+      command: 'npx',
+      args: ['-y', '@upstash/context7-mcp@latest']
+    }
+  };
+
+  let config = {};
+  if (fs.existsSync(claudeJsonPath)) {
+    try {
+      config = JSON.parse(fs.readFileSync(claudeJsonPath, 'utf-8'));
+    } catch {
+      config = {};
+    }
+  }
+
+  if (!config.mcpServers) config.mcpServers = {};
+
+  let added = [];
+  for (const [name, serverConfig] of Object.entries(mcpServers)) {
+    if (!config.mcpServers[name]) {
+      config.mcpServers[name] = serverConfig;
+      added.push(name);
+    }
+  }
+
+  fs.writeFileSync(claudeJsonPath, JSON.stringify(config, null, 2) + '\n');
+  return added;
+}
+
+// ── Settings Merge ───────────────────────────────────────────────────────────
+
+function mergeSettings(installDir, packageDir) {
+  const srcSettings = path.join(packageDir, 'settings.json');
+  if (!fs.existsSync(srcSettings)) return false;
+
+  const claudeDir = path.dirname(installDir);
+  const destSettings = path.join(claudeDir, 'settings.json');
+
+  const source = JSON.parse(fs.readFileSync(srcSettings, 'utf-8'));
+
+  let target = {};
+  if (fs.existsSync(destSettings)) {
+    try {
+      target = JSON.parse(fs.readFileSync(destSettings, 'utf-8'));
+    } catch {
+      target = {};
+    }
+  }
+
+  deepMerge(target, source);
+  fs.writeFileSync(destSettings, JSON.stringify(target, null, 2) + '\n');
+  return true;
+}
+
+// ── Main ─────────────────────────────────────────────────────────────────────
+
+async function main() {
+  console.log('');
+  console.log('  ╔═══════════════════════════════════════╗');
+  console.log('  ║   QAA — QA Automation Agent Installer ║');
+  console.log('  ╚═══════════════════════════════════════╝');
+  console.log('');
+
+  // Determine package root (where the npm package files are)
+  const packageDir = path.resolve(__dirname, '..');
+
+  // Check that package files exist
+  const requiredDirs = ['agents', 'commands', 'skills'];
+  const missing = requiredDirs.filter(d => !fs.existsSync(path.join(packageDir, d)));
+  if (missing.length > 0) {
+    fail(`Package incomplete — missing: ${missing.join(', ')}`);
+    process.exit(1);
+  }
+
+  // Ask install scope
+  console.log('  Install scope:');
+  console.log('    1) Global  — ~/.claude/qaa  (available in all projects)');
+  console.log('    2) Local   — ./.claude/qaa  (this project only)');
+  console.log('');
+  const scopeChoice = await ask('Choose [1/2] (default: 1):');
+  const isGlobal = scopeChoice !== '2';
+
+  const homeDir = process.env.HOME || process.env.USERPROFILE;
+  const claudeDir = isGlobal
+    ? path.join(homeDir, '.claude')
+    : path.join(process.cwd(), '.claude');
+  const installDir = path.join(claudeDir, 'qaa');
+
+  // Check for existing installation
+  if (fs.existsSync(installDir)) {
+    const overwrite = await ask('QAA already installed at this location. Overwrite? [y/N]:');
+    if (overwrite.toLowerCase() !== 'y') {
+      log('Installation cancelled.');
+      process.exit(0);
+    }
+  }
+
+  console.log('');
+  log(`Installing to: ${installDir}`);
+  console.log('');
+
+  // ── Step 1: Copy files ──────────────────────────────────────────────────
+
+  const dirsToCopy = ['agents', 'commands', 'skills', 'templates', 'workflows', 'docs', 'bin'];
+  const filesToCopy = ['CLAUDE.md', 'CHANGELOG.md', '.mcp.json', 'package.json'];
+
+  let totalFiles = 0;
+
+  for (const dir of dirsToCopy) {
+    const src = path.join(packageDir, dir);
+    const dest = path.join(installDir, dir);
+    if (fs.existsSync(src)) {
+      const count = copyDirRecursive(src, dest);
+      success(`${dir}/ — ${count} files`);
+      totalFiles += count;
+    }
+  }
+
+  for (const file of filesToCopy) {
+    const src = path.join(packageDir, file);
+    const dest = path.join(installDir, file);
+    if (fs.existsSync(src)) {
+      fs.mkdirSync(path.dirname(dest), { recursive: true });
+      fs.copyFileSync(src, dest);
+      success(file);
+      totalFiles++;
+    }
+  }
+
+  console.log('');
+
+  // ── Step 2: Register MCP servers ────────────────────────────────────────
+
+  const claudeJsonPath = path.join(homeDir, '.claude.json');
+  const addedMcps = registerMcpServers(claudeJsonPath);
+
+  if (addedMcps.length > 0) {
+    success(`MCP servers registered: ${addedMcps.join(', ')} → ${claudeJsonPath}`);
+  } else {
+    success('MCP servers already configured (playwright, context7)');
+  }
+
+  // ── Step 3: Merge settings ──────────────────────────────────────────────
+
+  const settingsMerged = mergeSettings(installDir, packageDir);
+  if (settingsMerged) {
+    success('Permissions merged into settings.json');
+  }
+
+  // ── Done ────────────────────────────────────────────────────────────────
+
+  console.log('');
+  console.log('  ╔═══════════════════════════════════════╗');
+  console.log('  ║         Installation complete!        ║');
+  console.log('  ╚═══════════════════════════════════════╝');
+  console.log('');
+  log(`${totalFiles} files installed to ${installDir}`);
+  log('MCP servers: playwright, context7');
+  log('');
+  log('Restart Claude Code, then run any QAA command:');
+  log('  /qa-start --dev-repo ./your-project');
+  log('  /qa-create-test login');
+  log('  /qa-map');
+  console.log('');
+}
+
+main().catch(err => {
+  fail(err.message);
+  process.exit(1);
+});

package/commands/qa-audit.md

@@ -42,6 +42,7 @@ else:
 Scores across 6 dimensions: Locator Quality (20%), Assertion Specificity (20%), POM Compliance (15%), Test Coverage (20%), Naming Convention (15%), Test Data Management (10%).
 
 1. Read `CLAUDE.md` — quality gates, locator tiers, assertion rules, POM rules, naming conventions.
+1b. Read `~/.claude/qaa/MY_PREFERENCES.md` if it exists — user/company preferences override CLAUDE.md defaults.
 2. Invoke validator agent in audit mode:
 
 Task(
@@ -50,6 +51,8 @@ Task(
     <execution_context>@agents/qaa-validator.md</execution_context>
     <files_to_read>
     - CLAUDE.md
+    - ~/.claude/qaa/MY_PREFERENCES.md (if exists)
+    - .qa-output/locators/LOCATOR_REGISTRY.md (if exists)
     </files_to_read>
     <parameters>
     user_input: $ARGUMENTS
@@ -68,6 +71,7 @@ Task(
 Analyze test distribution against the ideal testing pyramid from CLAUDE.md (Unit 60-70%, Integration 10-15%, API 20-25%, E2E 3-5%). Compares actual percentages to targets and produces an action plan.
 
 1. Read `CLAUDE.md` — testing pyramid target percentages.
+1b. Read `~/.claude/qaa/MY_PREFERENCES.md` if it exists — user/company preferences override CLAUDE.md defaults.
 2. Invoke analyzer agent for pyramid analysis:
 
 Task(
@@ -76,6 +80,7 @@ Task(
     <execution_context>@agents/qaa-analyzer.md</execution_context>
     <files_to_read>
     - CLAUDE.md
+    - ~/.claude/qaa/MY_PREFERENCES.md (if exists)
     </files_to_read>
     <parameters>
     user_input: $ARGUMENTS
@@ -98,6 +103,7 @@ Generate a summary report of current QA status. Adapts detail level to audience.
 - `client` — coverage summary, confidence level, test pass rates, risk mitigation status
 
 1. Read `CLAUDE.md` — testing pyramid targets, quality gates.
+1b. Read `~/.claude/qaa/MY_PREFERENCES.md` if it exists — user/company preferences override CLAUDE.md defaults.
 2. Invoke analyzer agent for status reporting:
 
 Task(
@@ -106,6 +112,7 @@ Task(
     <execution_context>@agents/qaa-analyzer.md</execution_context>
     <files_to_read>
     - CLAUDE.md
+    - ~/.claude/qaa/MY_PREFERENCES.md (if exists)
     </files_to_read>
     <parameters>
     user_input: $ARGUMENTS

package/commands/qa-create-test.md

@@ -81,6 +81,7 @@ App URL: {url or "auto-detect"}
 ### FROM CODE MODE
 
 1. Read `CLAUDE.md` — POM rules, locator tiers, assertion rules, naming conventions, quality gates.
+1b. Read `~/.claude/qaa/MY_PREFERENCES.md` if it exists — user's personal QA preferences override CLAUDE.md defaults when there is a conflict.
 2. Read existing analysis artifacts if available:
    - `.qa-output/QA_ANALYSIS.md` — architecture context
    - `.qa-output/TEST_INVENTORY.md` — pre-defined test cases for this feature
@@ -127,6 +128,7 @@ Task(
     <execution_context>@agents/qaa-executor.md</execution_context>
     <files_to_read>
     - CLAUDE.md
+    - ~/.claude/qaa/MY_PREFERENCES.md (if exists)
     - .qa-output/locators/LOCATOR_REGISTRY.md (if exists)
     - .qa-output/locators/{feature}.locators.md (if exists)
     - .qa-output/codebase/CODE_PATTERNS.md (if exists)
@@ -151,6 +153,8 @@ Task(
     <execution_context>@agents/qaa-e2e-runner.md</execution_context>
     <files_to_read>
     - CLAUDE.md
+    - ~/.claude/qaa/MY_PREFERENCES.md (if exists)
+    - .qa-output/locators/LOCATOR_REGISTRY.md (if exists)
     - {generated E2E test files from executor return}
     - {generated POM files from executor return}
     </files_to_read>
@@ -210,6 +214,7 @@ Task(
     <execution_context>@agents/qaa-validator.md</execution_context>
     <files_to_read>
     - CLAUDE.md
+    - ~/.claude/qaa/MY_PREFERENCES.md (if exists)
     </files_to_read>
     <parameters>
     user_input: $ARGUMENTS
@@ -228,6 +233,7 @@ Task(
     <execution_context>@agents/qaa-executor.md</execution_context>
     <files_to_read>
     - CLAUDE.md
+    - ~/.claude/qaa/MY_PREFERENCES.md (if exists)
     - .qa-output/QA_AUDIT_REPORT.md
     - .qa-output/locators/LOCATOR_REGISTRY.md (if exists)
     </files_to_read>
@@ -262,6 +268,7 @@ Task(
     <execution_context>@agents/qaa-executor.md</execution_context>
     <files_to_read>
     - CLAUDE.md
+    - ~/.claude/qaa/MY_PREFERENCES.md (if exists)
     - .qa-output/locators/LOCATOR_REGISTRY.md (if exists)
     </files_to_read>
     <parameters>
@@ -286,3 +293,26 @@ Task(
 - Every POM extends BasePage
 
 $ARGUMENTS
+
+## MANDATORY verification — run ALL commands below, no exceptions, no skipping
+
+Before returning control, copy-paste and run this ENTIRE block. Do NOT decide which commands "apply" — run all of them every time. The output confirms what happened; you do not get to assume the answer.
+
+```bash
+echo "=== CHECKLIST START ==="
+echo "1. Locator Registry:"
+ls .qa-output/locators/ 2>/dev/null || echo "NO_LOCATORS_FOUND"
+echo "2. MY_PREFERENCES.md:"
+cat ~/.claude/qaa/MY_PREFERENCES.md 2>/dev/null || echo "FILE_NOT_FOUND"
+echo "3. Generated test files:"
+find tests/ pages/ fixtures/ -type f 2>/dev/null | head -20 || echo "NO_TEST_FILES_FOUND"
+echo "4. MCP evidence (if browser was used):"
+ls .qa-output/mcp-evidence/ 2>/dev/null || echo "NO_MCP_EVIDENCE"
+echo "=== CHECKLIST END ==="
+```
+
+**Rules:**
+- Run the block AS-IS. Do not modify it. Do not split it. Do not skip lines.
+- If any output shows a problem (NO_LOCATORS when MCP was used, NO_TEST_FILES after generation), fix it before returning.
+- If output shows expected "not found" results (e.g., NO_MCP_EVIDENCE when no browser was used), that is fine — the point is you RAN the command instead of assuming the answer.
+- Do NOT mark this task as complete until the block has been executed and you have read every line of output.

package/commands/qa-fix.md

@@ -335,6 +335,8 @@ Task(
     <execution_context>@agents/qaa-e2e-runner.md</execution_context>
     <files_to_read>
     - CLAUDE.md
+    - ~/.claude/qaa/MY_PREFERENCES.md (if exists)
+    - .qa-output/locators/LOCATOR_REGISTRY.md (if exists)
     - {E2E test files from validated directory}
     - {POM files from validated directory}
     </files_to_read>
@@ -364,6 +366,8 @@ Task(
     <execution_context>@agents/qaa-bug-detective.md</execution_context>
     <files_to_read>
     - CLAUDE.md
+    - ~/.claude/qaa/MY_PREFERENCES.md (if exists)
+    - .qa-output/locators/LOCATOR_REGISTRY.md (if exists)
     </files_to_read>
     <parameters>
     user_input: $ARGUMENTS

package/commands/qa-map.md

@@ -99,6 +99,7 @@ Task(
     <execution_context>@agents/qaa-scanner.md</execution_context>
     <files_to_read>
     - CLAUDE.md
+    - ~/.claude/qaa/MY_PREFERENCES.md (if exists)
     </files_to_read>
     <parameters>
     user_input: $ARGUMENTS
@@ -114,6 +115,7 @@ Task(
     <execution_context>@agents/qaa-analyzer.md</execution_context>
     <files_to_read>
     - CLAUDE.md
+    - ~/.claude/qaa/MY_PREFERENCES.md (if exists)
     - .qa-output/SCAN_MANIFEST.md
     - .qa-output/codebase/TESTABILITY.md (if exists)
     - .qa-output/codebase/RISK_MAP.md (if exists)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qaa-agent",
-  "version": "1.7.4",
+  "version": "1.8.1",
   "description": "QA Automation Agent for Claude Code — multi-agent pipeline that analyzes repos, generates tests, validates, and creates PRs",
   "bin": {
     "qaa-agent": "./bin/install.cjs"
@@ -22,7 +22,8 @@
   "author": "Backhaus7997",
   "license": "MIT",
   "dependencies": {
-    "@playwright/mcp": "latest"
+    "@playwright/mcp": "latest",
+    "@upstash/context7-mcp": "latest"
   },
   "files": [
     "bin/",