agentic-qe 3.1.4 → 3.1.5

package/CHANGELOG.md

@@ -5,6 +5,16 @@ All notable changes to the Agentic QE project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.1.5] - 2026-01-22
+
+### Added
+
+- **Root-level preinstall script** - Added migration detection for users upgrading from:
+  - `@agentic-qe/v3` (alpha package) → `agentic-qe@latest`
+  - `agentic-qe` v2 → `agentic-qe@latest`
+  - Provides clear instructions to resolve binary conflicts
+  - Supports `AQE_AUTO_MIGRATE=true` for automatic migration
+
 ## [3.1.4] - 2026-01-22
 
 ### Changed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-qe",
-  "version": "3.1.4",
+  "version": "3.1.5",
   "description": "Agentic Quality Engineering V3 - Domain-Driven Design Architecture with 12 Bounded Contexts, O(log n) coverage analysis, ReasoningBank learning, 51 specialized QE agents, deep Claude Flow integration",
   "main": "./v3/dist/index.js",
   "types": "./v3/dist/index.d.ts",
@@ -11,6 +11,7 @@
     "aqe-mcp": "./v3/dist/mcp/bundle.js"
   },
   "scripts": {
+    "preinstall": "node scripts/preinstall.cjs || true",
     "postinstall": "test -f v3/package.json && cd v3 && npm install || true",
     "build": "cd v3 && npm run build",
     "test": "cd v3 && npm test -- --run",
@@ -132,6 +133,7 @@
     "v3/dist/**",
     "v3/assets/**",
     "v3/package.json",
+    "scripts/**",
     ".claude/agents",
     ".claude/skills",
     ".claude/commands",

package/scripts/preinstall.cjs

@@ -0,0 +1,260 @@
+#!/usr/bin/env node
+
+/**
+ * Preinstall script for agentic-qe
+ * Detects and handles conflicts from:
+ * - agentic-qe v2 (old package)
+ * - @agentic-qe/v3 (alpha package)
+ *
+ * Uses CommonJS for maximum Node.js compatibility
+ */
+
+const { execSync, spawnSync } = require('child_process');
+const { existsSync, unlinkSync, lstatSync } = require('fs');
+const { join } = require('path');
+
+const RESET = '\x1b[0m';
+const BOLD = '\x1b[1m';
+const YELLOW = '\x1b[33m';
+const GREEN = '\x1b[32m';
+const CYAN = '\x1b[36m';
+const RED = '\x1b[31m';
+
+function log(msg) {
+  console.log(`${CYAN}[agentic-qe]${RESET} ${msg}`);
+}
+
+function warn(msg) {
+  console.log(`${YELLOW}[agentic-qe]${RESET} ${msg}`);
+}
+
+function error(msg) {
+  console.log(`${RED}[agentic-qe]${RESET} ${msg}`);
+}
+
+function success(msg) {
+  console.log(`${GREEN}[agentic-qe]${RESET} ${msg}`);
+}
+
+function findExistingAqeBinary() {
+  // Try 'which' command first
+  try {
+    const result = spawnSync('which', ['aqe'], { encoding: 'utf-8' });
+    if (result.status === 0 && result.stdout.trim()) {
+      return result.stdout.trim();
+    }
+  } catch {
+    // which command failed
+  }
+
+  // Try to find via npm prefix
+  try {
+    const prefix = execSync('npm config get prefix', { encoding: 'utf-8' }).trim();
+    const binPath = join(prefix, 'bin', 'aqe');
+    if (existsSync(binPath)) {
+      return binPath;
+    }
+  } catch {
+    // Ignore
+  }
+
+  return null;
+}
+
+function checkPackageInstalled(packageName) {
+  try {
+    const result = execSync(`npm list -g ${packageName} --depth=0 2>/dev/null`, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+    return result.includes(`${packageName}@`);
+  } catch {
+    return false;
+  }
+}
+
+function getPackageVersion(packageName) {
+  try {
+    const result = execSync(`npm list -g ${packageName} --depth=0 2>/dev/null`, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe']
+    });
+    const regex = new RegExp(`${packageName.replace('/', '\\/')}@([\\d\\.\\-a-z]+)`);
+    const match = result.match(regex);
+    return match ? match[1] : null;
+  } catch {
+    return null;
+  }
+}
+
+function uninstallPackage(packageName) {
+  try {
+    log(`Uninstalling ${packageName}...`);
+    execSync(`npm uninstall -g ${packageName}`, {
+      encoding: 'utf-8',
+      stdio: 'inherit'
+    });
+    success(`Successfully uninstalled ${packageName}`);
+    return true;
+  } catch (err) {
+    error(`Failed to uninstall ${packageName}: ${err.message}`);
+    return false;
+  }
+}
+
+function removeStaleSymlink(binaryPath) {
+  try {
+    const stats = lstatSync(binaryPath);
+    if (stats.isSymbolicLink()) {
+      unlinkSync(binaryPath);
+      success(`Removed stale symlink: ${binaryPath}`);
+      return true;
+    }
+  } catch {
+    // Not a symlink or can't remove
+  }
+  return false;
+}
+
+function main() {
+  // Skip in CI environments unless explicitly requested
+  if (process.env.CI && !process.env.AQE_PREINSTALL_CHECK) {
+    return;
+  }
+
+  const aqeBinary = findExistingAqeBinary();
+
+  // Check for both old package names
+  const v2Installed = checkPackageInstalled('agentic-qe');
+  const alphaInstalled = checkPackageInstalled('@agentic-qe/v3');
+
+  const v2Version = v2Installed ? getPackageVersion('agentic-qe') : null;
+  const alphaVersion = alphaInstalled ? getPackageVersion('@agentic-qe/v3') : null;
+
+  // If the currently installed agentic-qe is version 3.x, we're good (user is upgrading within v3)
+  if (v2Version && v2Version.startsWith('3.')) {
+    // User is upgrading from 3.x to newer 3.x - this should work normally
+    return;
+  }
+
+  if (!aqeBinary && !v2Installed && !alphaInstalled) {
+    // Clean install, nothing to do
+    return;
+  }
+
+  console.log('');
+  log(`${BOLD}Checking for existing agentic-qe installation...${RESET}`);
+
+  // Handle alpha package conflict
+  if (alphaInstalled) {
+    warn(`Found @agentic-qe/v3@${alphaVersion || 'alpha'} installed globally`);
+    warn('The alpha package uses the same "aqe" binary name as the released version');
+    console.log('');
+
+    // Check if we can auto-migrate
+    const autoMigrate = process.env.AQE_AUTO_MIGRATE === 'true' ||
+                        process.env.npm_config_yes === 'true';
+
+    if (autoMigrate) {
+      log('Auto-migrating from alpha to release...');
+      if (uninstallPackage('@agentic-qe/v3')) {
+        success('Migration complete. Continuing with install...');
+        return;
+      } else {
+        error('Auto-migration failed. Please run manually:');
+        console.log(`  ${CYAN}npm uninstall -g @agentic-qe/v3 && npm install -g agentic-qe@latest${RESET}`);
+        process.exit(1);
+      }
+    }
+
+    // Interactive mode
+    console.log(`${YELLOW}To upgrade from alpha to release:${RESET}`);
+    console.log('');
+    console.log(`  ${BOLD}Option 1: Auto-migrate (recommended)${RESET}`);
+    console.log(`  ${CYAN}AQE_AUTO_MIGRATE=true npm install -g agentic-qe@latest${RESET}`);
+    console.log('');
+    console.log(`  ${BOLD}Option 2: Manual uninstall first${RESET}`);
+    console.log(`  ${CYAN}npm uninstall -g @agentic-qe/v3${RESET}`);
+    console.log(`  ${CYAN}npm install -g agentic-qe@latest${RESET}`);
+    console.log('');
+    console.log(`  ${BOLD}Option 3: Force overwrite${RESET}`);
+    console.log(`  ${CYAN}npm install -g agentic-qe@latest --force${RESET}`);
+    console.log('');
+
+    process.exit(1);
+  }
+
+  // Handle v2 package conflict
+  if (v2Installed && !v2Version?.startsWith('3.')) {
+    warn(`Found agentic-qe v${v2Version || '2.x'} installed globally`);
+    warn('The v2 package uses the same "aqe" binary name as v3');
+    console.log('');
+
+    const autoMigrate = process.env.AQE_AUTO_MIGRATE === 'true' ||
+                        process.env.npm_config_yes === 'true';
+
+    if (autoMigrate) {
+      log('Auto-migrating from v2 to v3...');
+      if (uninstallPackage('agentic-qe')) {
+        success('Migration complete. Continuing with v3 install...');
+        return;
+      } else {
+        error('Auto-migration failed. Please run manually:');
+        console.log(`  ${CYAN}npm uninstall -g agentic-qe && npm install -g agentic-qe@latest${RESET}`);
+        process.exit(1);
+      }
+    }
+
+    console.log(`${YELLOW}To upgrade from v2 to v3:${RESET}`);
+    console.log('');
+    console.log(`  ${BOLD}Option 1: Auto-migrate (recommended)${RESET}`);
+    console.log(`  ${CYAN}AQE_AUTO_MIGRATE=true npm install -g agentic-qe@latest${RESET}`);
+    console.log('');
+    console.log(`  ${BOLD}Option 2: Manual uninstall first${RESET}`);
+    console.log(`  ${CYAN}npm uninstall -g agentic-qe${RESET}`);
+    console.log(`  ${CYAN}npm install -g agentic-qe@latest${RESET}`);
+    console.log('');
+    console.log(`  ${BOLD}Option 3: Force overwrite${RESET}`);
+    console.log(`  ${CYAN}npm install -g agentic-qe@latest --force${RESET}`);
+    console.log('');
+
+    process.exit(1);
+
+  } else if (aqeBinary && !v2Installed && !alphaInstalled) {
+    // Binary exists but no known package found - stale symlink or different package
+    warn(`Found existing 'aqe' binary at: ${aqeBinary}`);
+
+    // Try to identify what it's from
+    try {
+      const realpath = require('fs').realpathSync(aqeBinary);
+      if (realpath.includes('agentic-qe')) {
+        warn('This appears to be from a previous agentic-qe installation.');
+      }
+    } catch {
+      // Can't resolve realpath
+    }
+
+    console.log('');
+    console.log(`${YELLOW}To resolve the conflict:${RESET}`);
+    console.log('');
+    console.log(`  ${BOLD}Option 1: Remove existing binary${RESET}`);
+    console.log(`  ${CYAN}rm ${aqeBinary}${RESET}`);
+    console.log(`  ${CYAN}npm install -g agentic-qe@latest${RESET}`);
+    console.log('');
+    console.log(`  ${BOLD}Option 2: Force overwrite${RESET}`);
+    console.log(`  ${CYAN}npm install -g agentic-qe@latest --force${RESET}`);
+    console.log('');
+
+    process.exit(1);
+  }
+}
+
+try {
+  main();
+} catch (err) {
+  // Don't let preinstall failures block installation
+  // Just log and continue
+  if (process.env.DEBUG) {
+    error(`Preinstall check error: ${err.message}`);
+  }
+}

package/scripts/test-dashboard.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+/**
+ * Test Dashboard Generator
+ * Generates a simple test metrics dashboard for CI
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Find all test files
+function findTestFiles(dir, files = []) {
+  if (!fs.existsSync(dir)) return files;
+
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      findTestFiles(fullPath, files);
+    } else if (entry.name.endsWith('.test.ts') || entry.name.endsWith('.spec.ts')) {
+      files.push(fullPath);
+    }
+  }
+  return files;
+}
+
+// Count tests in a file (simple heuristic)
+function countTests(filePath) {
+  try {
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const itMatches = content.match(/\bit\s*\(/g) || [];
+    const testMatches = content.match(/\btest\s*\(/g) || [];
+    return itMatches.length + testMatches.length;
+  } catch {
+    return 0;
+  }
+}
+
+// Main
+const testDirs = ['tests', 'v3/tests'];
+let totalFiles = 0;
+let totalTests = 0;
+const categories = {};
+
+for (const dir of testDirs) {
+  const files = findTestFiles(dir);
+  for (const file of files) {
+    totalFiles++;
+    const tests = countTests(file);
+    totalTests += tests;
+
+    // Categorize
+    if (file.includes('/unit/')) {
+      categories.unit = (categories.unit || 0) + tests;
+    } else if (file.includes('/integration/')) {
+      categories.integration = (categories.integration || 0) + tests;
+    } else if (file.includes('/e2e/')) {
+      categories.e2e = (categories.e2e || 0) + tests;
+    } else {
+      categories.other = (categories.other || 0) + tests;
+    }
+  }
+}
+
+console.log('# Test Dashboard');
+console.log('');
+console.log(`**Total Test Files**: ${totalFiles}`);
+console.log(`**Total Tests**: ${totalTests}`);
+console.log('');
+console.log('## By Category');
+for (const [cat, count] of Object.entries(categories)) {
+  console.log(`- **${cat}**: ${count} tests`);
+}
+console.log('');
+console.log('Dashboard generated successfully.');

package/v3/dist/cli/bundle.js

@@ -83268,7 +83268,7 @@ async function cleanupAndExit(code = 0) {
   process.exit(code);
 }
 var program = new Command4();
-var VERSION = true ? "3.1.4" : "0.0.0-dev";
+var VERSION = true ? "3.1.5" : "0.0.0-dev";
 program.name("aqe").description("Agentic QE - Domain-Driven Quality Engineering").version(VERSION);
 program.command("init").description("Initialize the AQE v3 system").option("-d, --domains <domains>", "Comma-separated list of domains to enable", "all").option("-m, --max-agents <number>", "Maximum concurrent agents", "15").option("--memory <backend>", "Memory backend (sqlite|agentdb|hybrid)", "hybrid").option("--lazy", "Enable lazy loading of domains").option("--wizard", "Run interactive setup wizard").option("--auto", "Auto-configure based on project analysis").option("--minimal", "Minimal configuration (skip optional features)").option("--skip-patterns", "Skip loading pre-trained patterns").option("--with-n8n", "Install n8n workflow testing agents and skills").option("--auto-migrate", "Automatically migrate from v2 if detected").action(async (options) => {
   try {

package/v3/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentic-qe/v3",
-  "version": "3.1.4",
+  "version": "3.1.5",
   "description": "Agentic QE v3 - Domain-Driven Design Architecture with 12 Bounded Contexts, O(log n) coverage analysis, ReasoningBank learning, 51 specialized QE agents",
   "type": "module",
   "main": "./dist/index.js",