qaa-agent 1.6.2 → 1.7.0

package/bin/install.cjs

@@ -1,198 +1,200 @@
-#!/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
-  const commandsSrc = path.join(ROOT, '.claude', 'commands');
-  const commandsDest = path.join(baseDir, 'commands');
-  const cmdCount = copyDir(commandsSrc, commandsDest);
-  ok(`Installed ${cmdCount} slash commands`);
-
-  // Install skills (only to baseDir -- Claude Code reads from ~/.claude/skills/)
-  const skillsSrc = path.join(ROOT, '.claude', '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)) {
-    const mcpDest = path.join(qaaDir, '.mcp.json');
-    copyFile(mcpSrc, mcpDest);
-    ok('Installed Playwright MCP server config (.mcp.json)');
-  }
-
-  // Write version
-  fs.writeFileSync(path.join(qaaDir, 'VERSION'), VERSION);
-  ok(`Wrote VERSION (${VERSION})`);
-
-  // Merge settings
-  const settingsSrc = path.join(ROOT, '.claude', '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/create-test\x1b[0m       Tests for a feature');
-  console.log('    \x1b[1m/qa-from-ticket\x1b[0m    Tests from a Jira/Linear ticket');
-  console.log('    \x1b[1m/qa-validate\x1b[0m       Validate existing tests');
-  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 - 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)) {
+    const mcpDest = path.join(qaaDir, '.mcp.json');
+    copyFile(mcpSrc, mcpDest);
+    ok('Installed Playwright MCP server config (.mcp.json)');
+  }
+
+  // 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);
+});