agentic-qe 3.1.3 → 3.1.5

package/CHANGELOG.md

@@ -5,6 +5,27 @@ 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
+
+- **Major dependency cleanup** - Removed 49 unused dependencies from root package.json
+  - Reduced from 66 to 17 production dependencies
+  - Removed unused: @anthropic-ai/sdk, @babel/*, @modelcontextprotocol/sdk, @opentelemetry/*, @supabase/*, agentdb, agentic-flow, ajv, axe-core, chokidar, cors, dockerode, express, fs-extra, graphql, inquirer, ioredis, openai, pg, playwright, react-dom, tree-sitter-*, ts-morph, web-tree-sitter, winston, ws, and more
+  - Kept only packages actually imported in v3/src: uuid, better-sqlite3, chalk, commander, typescript, @faker-js/faker, @ruvector/{attention,gnn,sona}, @xenova/transformers, hnswlib-node, fast-glob, ora, cli-progress, secure-json-parse, yaml, vibium
+  - Significantly faster npm install for users
+  - Smaller package footprint
+
 ## [3.1.3] - 2026-01-22
 
 ### Fixed

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-qe",
-  "version": "3.1.3",
+  "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",
@@ -65,83 +66,29 @@
   "author": "AQE Development Team",
   "license": "MIT",
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.64.0",
-    "@babel/parser": "^7.24.0",
-    "@babel/traverse": "^7.24.0",
-    "@modelcontextprotocol/sdk": "^1.25.2",
-    "@msgpack/msgpack": "^3.1.2",
-    "@opentelemetry/api": "^1.9.0",
-    "@opentelemetry/auto-instrumentations-node": "^0.50.0",
-    "@opentelemetry/exporter-metrics-otlp-grpc": "^0.55.0",
-    "@opentelemetry/exporter-metrics-otlp-http": "^0.55.0",
-    "@opentelemetry/exporter-trace-otlp-grpc": "^0.55.0",
-    "@opentelemetry/exporter-trace-otlp-http": "^0.55.0",
-    "@opentelemetry/resources": "^1.28.0",
-    "@opentelemetry/sdk-logs": "^0.55.0",
-    "@opentelemetry/sdk-metrics": "^1.28.0",
-    "@opentelemetry/sdk-node": "^0.55.0",
-    "@opentelemetry/sdk-trace-base": "^1.28.0",
-    "@opentelemetry/sdk-trace-node": "^1.28.0",
-    "@opentelemetry/semantic-conventions": "^1.28.0",
+    "@faker-js/faker": "^10.2.0",
     "@ruvector/attention": "0.1.3",
-    "@ruvector/core": "^0.1.15",
     "@ruvector/gnn": "0.1.19",
-    "@ruvector/nervous-system-wasm": "^0.1.29",
-    "@ruvector/ruvllm": "^0.2.3",
     "@ruvector/sona": "0.1.5",
-    "@supabase/supabase-js": "^2.89.0",
-    "@types/cli-progress": "^3.11.6",
-    "@types/pg": "^8.16.0",
-    "@types/ws": "^8.18.1",
     "@xenova/transformers": "^2.6.0",
-    "agentdb": "^1.6.1",
-    "agentic-flow": "^1.10.2",
-    "ajv": "^8.17.1",
-    "ajv-formats": "^3.0.1",
-    "axe-core": "^4.11.0",
     "better-sqlite3": "^12.4.1",
     "chalk": "^4.1.2",
-    "chokidar": "^3.6.0",
     "cli-progress": "^3.12.0",
-    "cli-table3": "^0.6.5",
     "commander": "^14.0.1",
-    "cors": "^2.8.5",
-    "dockerode": "^4.0.9",
-    "express": "^5.2.1",
     "fast-glob": "^3.3.3",
-    "fs-extra": "^11.1.1",
-    "graphql": "^16.11.0",
     "hnswlib-node": "^3.0.0",
-    "inquirer": "^8.2.6",
-    "ioredis": "^5.8.2",
-    "openai": "^6.9.1",
     "ora": "^5.4.1",
-    "pg": "^8.16.3",
-    "playwright": "^1.57.0",
-    "react-dom": "^19.2.3",
-    "ruvector": "0.1.24",
     "secure-json-parse": "^4.1.0",
-    "tree-sitter-wasms": "^0.1.13",
-    "ts-morph": "^27.0.2",
+    "typescript": "^5.9.3",
     "uuid": "^11.0.5",
     "vibium": "^0.1.2",
-    "web-tree-sitter": "^0.22.6",
-    "winston": "^3.18.3",
-    "ws": "^8.18.3",
-    "yaml": "^2.8.1",
-    "typescript": "^5.9.3",
-    "@faker-js/faker": "^10.2.0"
+    "yaml": "^2.8.1"
   },
   "optionalDependencies": {
     "@ruvector/attention-darwin-arm64": "0.1.3",
     "@ruvector/attention-linux-arm64-gnu": "0.1.3",
-    "@ruvector/edge": "^0.1.9",
     "@ruvector/gnn-darwin-arm64": "0.1.19",
-    "@ruvector/gnn-linux-arm64-gnu": "0.1.19",
-    "@ruvector/node-linux-arm64-gnu": "^0.1.16",
-    "@ruvector/node-linux-x64-gnu": "^0.1.16",
-    "ruvector-core-linux-arm64-gnu": "^0.1.15",
-    "ruvector-core-linux-x64-gnu": "^0.1.15"
+    "@ruvector/gnn-linux-arm64-gnu": "0.1.19"
   },
   "resolutions": {
     "graceful-fs": "^4.2.11",
@@ -149,73 +96,26 @@
   },
   "overrides": {
     "@ruvector/gnn-linux-x64-musl": "npm:@ruvector/gnn-linux-x64-gnu@0.1.19",
-    "@ruvector/gnn-linux-arm64-musl": "npm:@ruvector/gnn-linux-arm64-gnu@0.1.19",
-    "tree-sitter-go": {
-      "tree-sitter": "$tree-sitter"
-    },
-    "tree-sitter-javascript": {
-      "tree-sitter": "$tree-sitter"
-    },
-    "tree-sitter-typescript": {
-      "tree-sitter": "$tree-sitter"
-    },
-    "tree-sitter-python": {
-      "tree-sitter": "$tree-sitter"
-    },
-    "tree-sitter-rust": {
-      "tree-sitter": "$tree-sitter"
-    }
+    "@ruvector/gnn-linux-arm64-musl": "npm:@ruvector/gnn-linux-arm64-gnu@0.1.19"
   },
   "devDependencies": {
-    "@axe-core/playwright": "^4.11.0",
-    "@jest/globals": "^30.2.0",
-    "@jest/test-sequencer": "^30.2.0",
-    "@playwright/test": "^1.57.0",
-    "@tailwindcss/postcss": "^4.1.18",
-    "@testing-library/jest-dom": "^6.9.1",
-    "@testing-library/react": "^16.3.1",
     "@types/better-sqlite3": "^7.6.13",
-    "@types/cors": "^2.8.19",
-    "@types/dockerode": "^3.3.47",
-    "@types/express": "^5.0.5",
-    "@types/fs-extra": "^11.0.4",
-    "@types/graphql": "^14.2.3",
-    "@types/inquirer": "^8.2.10",
-    "@types/ioredis": "^4.28.10",
-    "@types/istanbul-lib-coverage": "^2.0.6",
-    "@types/jest": "^30.0.0",
-    "@types/js-yaml": "^4.0.9",
+    "@types/cli-progress": "^3.11.6",
     "@types/node": "^20.19.17",
-    "@types/react": "^18.3.27",
-    "@types/react-dom": "^18.3.7",
     "@types/uuid": "^10.0.0",
     "@typescript-eslint/eslint-plugin": "^6.13.0",
     "@typescript-eslint/parser": "^6.13.0",
-    "@vitejs/plugin-react": "^5.1.2",
-    "autoprefixer": "^10.4.23",
     "dotenv": "^17.2.3",
     "eslint": "^8.55.0",
     "eslint-plugin-security": "^3.0.1",
     "glob": "^11.0.0",
     "graceful-fs": "^4.2.11",
-    "identity-obj-proxy": "^3.0.0",
-    "istanbul-lib-coverage": "^3.2.2",
-    "jest": "^30.2.0",
-    "jest-environment-jsdom": "^30.2.0",
-    "jest-extended": "^6.0.0",
-    "jest-junit": "^16.0.0",
-    "nodemon": "^3.0.2",
-    "postcss": "^8.5.6",
-    "react": "^19.2.3",
     "rimraf": "^6.0.1",
     "stack-utils": "^2.0.6",
-    "tailwindcss": "^4.1.18",
     "tinybench": "^2.9.0",
-    "ts-jest": "^29.4.4",
     "ts-node": "^10.9.1",
     "tsx": "^4.20.6",
-    "typedoc": "^0.28.13",
-    "vite": "^7.3.0"
+    "typedoc": "^0.28.13"
   },
   "engines": {
     "node": ">=18.0.0",
@@ -233,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.3" : "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.3",
+  "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",
@@ -114,10 +114,10 @@
   },
   "optionalDependencies": {
     "@claude-flow/browser": "^3.0.0",
-    "@ruvector/attention-linux-arm64-gnu": "0.1.3",
     "@ruvector/attention-darwin-arm64": "0.1.3",
-    "@ruvector/gnn-linux-arm64-gnu": "0.1.19",
-    "@ruvector/gnn-darwin-arm64": "0.1.19"
+    "@ruvector/attention-linux-arm64-gnu": "0.1.3",
+    "@ruvector/gnn-darwin-arm64": "0.1.19",
+    "@ruvector/gnn-linux-arm64-gnu": "0.1.19"
   },
   "overrides": {
     "@ruvector/gnn-linux-x64-musl": "npm:@ruvector/gnn-linux-x64-gnu@0.1.19",