agentic-qe 3.3.4 → 3.4.0

package/.claude/helpers/statusline-v3.cjs

@@ -18,6 +18,14 @@ const fs = require('fs');
 const path = require('path');
 const { execSync, spawnSync } = require('child_process');
 
+// Use better-sqlite3 for reliable database access (no CLI dependency)
+let Database;
+try {
+  Database = require('better-sqlite3');
+} catch {
+  Database = null; // Fallback to CLI if better-sqlite3 not available
+}
+
 // ═══════════════════════════════════════════════════════════════
 // Configuration
 // ═══════════════════════════════════════════════════════════════
@@ -31,10 +39,12 @@ const CONFIG = {
   flashAttentionTarget: '2.49x-7.47x',
   intelligenceTargetExp: 1000, // 1000 experiences = 100%
 
-  // Paths (V3 database takes priority - actively used)
+  // Paths - ROOT database is the consolidated source (MCP writes here)
+  // Priority: root > v3 (v3 db is stale, kept only for backup)
   memoryDbPaths: [
-    'v3/.agentic-qe/memory.db',    // V3 primary location (new schema)
-    '.agentic-qe/memory.db',        // Root fallback (old schema)
+    '.agentic-qe/memory.db',       // ROOT: Primary when CWD is project root
+    '../.agentic-qe/memory.db',    // ROOT: When CWD is v3/ or other subdirectory
+    'v3/.agentic-qe/memory.db',    // V3: Fallback only (stale after consolidation)
   ],
   cveCache: '.agentic-qe/.cve-cache',
   cveCacheAge: 3600, // 1 hour
@@ -115,8 +125,47 @@ function readJsonFile(filePath, defaultValue = {}) {
   return defaultValue;
 }
 
+// Database connection cache for performance
+let dbCache = new Map();
+
+function getDb(dbPath) {
+  if (!dbCache.has(dbPath)) {
+    if (Database && fileExists(dbPath)) {
+      try {
+        const db = new Database(dbPath, { readonly: true, fileMustExist: true });
+        dbCache.set(dbPath, db);
+      } catch {
+        dbCache.set(dbPath, null);
+      }
+    } else {
+      dbCache.set(dbPath, null);
+    }
+  }
+  return dbCache.get(dbPath);
+}
+
 function sqlite3Query(dbPath, query, defaultValue = '0') {
   if (!fileExists(dbPath)) return defaultValue;
+
+  // Prefer better-sqlite3 (Node.js native, no CLI dependency)
+  if (Database) {
+    try {
+      const db = getDb(dbPath);
+      if (db) {
+        const row = db.prepare(query).get();
+        if (row) {
+          // Return the first column value
+          const values = Object.values(row);
+          return values.length > 0 ? String(values[0]) : defaultValue;
+        }
+      }
+      return defaultValue;
+    } catch {
+      return defaultValue;
+    }
+  }
+
+  // Fallback to CLI if better-sqlite3 not available
   try {
     const result = execSync(`sqlite3 "${dbPath}" "${query}" 2>/dev/null`, {
       encoding: 'utf-8',
@@ -214,24 +263,14 @@ function getTestCounts(projectDir) {
 }
 
 function getLearningMetrics(projectDir) {
-  // Find active database (V3 takes priority)
+  // Find the consolidated V3 database
   let dbPath = null;
-  let isV3Schema = false;
 
   for (const relPath of CONFIG.memoryDbPaths) {
     const candidate = path.join(projectDir, relPath);
     if (fileExists(candidate)) {
-      // Check which schema this database uses
-      const hasV3Tables = sqlite3Query(candidate,
-        "SELECT name FROM sqlite_master WHERE type='table' AND name='qe_patterns'", '') !== '';
-      const hasOldTables = sqlite3Query(candidate,
-        "SELECT name FROM sqlite_master WHERE type='table' AND name='patterns'", '') !== '';
-
-      if (hasV3Tables || hasOldTables) {
-        dbPath = candidate;
-        isV3Schema = hasV3Tables;
-        break;
-      }
+      dbPath = candidate;
+      break;
     }
   }
 
@@ -243,36 +282,37 @@ function getLearningMetrics(projectDir) {
     };
   }
 
-  let patterns = 0, synthesized = 0, experiences = 0, transfers = 0, successRate = 0;
+  // Consolidated V3 DB has BOTH old schema tables (migrated) and new V3 tables
+  // Read from ALL relevant tables for complete metrics
 
-  if (isV3Schema) {
-    // V3 Schema: qe_patterns, qe_trajectories, sona_patterns
-    patterns = parseInt(sqlite3Query(dbPath, 'SELECT COUNT(*) FROM qe_patterns')) || 0;
-    synthesized = parseInt(sqlite3Query(dbPath, 'SELECT COUNT(*) FROM sona_patterns')) || 0;
+  // Legacy patterns (migrated from root DB)
+  const legacyPatterns = parseInt(sqlite3Query(dbPath, 'SELECT COUNT(*) FROM patterns')) || 0;
+  // V3 SONA patterns (new V3 neural patterns)
+  const sonaPatterns = parseInt(sqlite3Query(dbPath, 'SELECT COUNT(*) FROM sona_patterns')) || 0;
+  // Synthesized patterns (dream-generated)
+  const synthesized = parseInt(sqlite3Query(dbPath, 'SELECT COUNT(*) FROM synthesized_patterns')) || 0;
 
-    // Experiences: trajectories + claude-flow imported sessions
-    const trajectories = parseInt(sqlite3Query(dbPath, 'SELECT COUNT(*) FROM qe_trajectories')) || 0;
-    const cfExperiences = parseInt(sqlite3Query(dbPath,
-      "SELECT COUNT(*) FROM kv_store WHERE key LIKE 'cf:%'")) || 0;
-    experiences = trajectories + cfExperiences;
+  // Total patterns = legacy + SONA + synthesized
+  const patterns = legacyPatterns + sonaPatterns;
 
-    // V3 uses rl_q_values for transfer learning
-    transfers = parseInt(sqlite3Query(dbPath, 'SELECT COUNT(*) FROM rl_q_values')) || 0;
+  // Learning experiences (migrated from root DB)
+  const legacyExperiences = parseInt(sqlite3Query(dbPath, 'SELECT COUNT(*) FROM learning_experiences')) || 0;
+  // V3 trajectories (new V3 trajectory tracking)
+  const trajectories = parseInt(sqlite3Query(dbPath, 'SELECT COUNT(*) FROM qe_trajectories')) || 0;
+  // Captured experiences (task execution captures)
+  const capturedExp = parseInt(sqlite3Query(dbPath, 'SELECT COUNT(*) FROM captured_experiences')) || 0;
 
-    // Success rate from sona_patterns (claude-flow imports have outcome_success)
-    successRate = parseFloat(sqlite3Query(dbPath,
-      'SELECT ROUND(AVG(outcome_success)*100) FROM sona_patterns WHERE outcome_success > 0', '0')) || 0;
-  } else {
-    // Old Schema: patterns, learning_experiences, synthesized_patterns
-    patterns = parseInt(sqlite3Query(dbPath, 'SELECT COUNT(*) FROM patterns')) || 0;
-    synthesized = parseInt(sqlite3Query(dbPath, 'SELECT COUNT(*) FROM synthesized_patterns')) || 0;
-    experiences = parseInt(sqlite3Query(dbPath, 'SELECT COUNT(*) FROM learning_experiences')) || 0;
-    transfers = parseInt(sqlite3Query(dbPath, 'SELECT COUNT(*) FROM transfer_registry')) || 0;
-    successRate = parseFloat(sqlite3Query(dbPath,
-      'SELECT ROUND(AVG(success_rate)*100) FROM patterns WHERE success_rate > 0', '0')) || 0;
-  }
+  // Total experiences = all sources
+  const experiences = legacyExperiences + trajectories + capturedExp;
 
-  // Intelligence % based on experiences (target: 1000 = 100%)
+  // Transfer learning count
+  const transfers = parseInt(sqlite3Query(dbPath, 'SELECT COUNT(*) FROM transfer_registry')) || 0;
+
+  // Success rate from legacy patterns
+  const successRate = parseFloat(sqlite3Query(dbPath,
+    'SELECT ROUND(AVG(success_rate)*100) FROM patterns WHERE success_rate > 0', '0')) || 0;
+
+  // Intelligence % based on total learning data (target: 1000 = 100%)
   const totalLearningData = patterns + synthesized + experiences;
   const intelligencePct = Math.min(100, Math.floor((totalLearningData / CONFIG.intelligenceTargetExp) * 100));
 
@@ -287,6 +327,9 @@ function getLearningMetrics(projectDir) {
     }
   }
 
+  // Determine dbSource from which path was found
+  const dbSource = dbPath.includes('v3/.agentic-qe') ? 'v3' : 'root';
+
   return {
     patterns,
     synthesized,
@@ -296,7 +339,7 @@ function getLearningMetrics(projectDir) {
     successRate,
     intelligencePct,
     mode,
-    dbSource: isV3Schema ? 'v3' : 'root',
+    dbSource,  // 'root' = consolidated primary, 'v3' = legacy
   };
 }
 

package/.claude/skills/qcsd-ideation-swarm/SKILL.md

@@ -55,7 +55,7 @@ When analyzing a live website URL, use this specialized execution pattern.
 ### Parameters
 
 - `URL`: Website to analyze (required)
-- `OUTPUT_FOLDER`: Where to save reports (default: `/workspaces/agentic-qe/Agentic QCSD/{domain}/`)
+- `OUTPUT_FOLDER`: Where to save reports (default: `${PROJECT_ROOT}/Agentic QCSD/{domain}/` or `./Agentic QCSD/{domain}/`)
 
 ---
 
@@ -71,7 +71,10 @@ When analyzing a live website URL, use this specialized execution pattern.
 
 ```bash
 # SINGLE COMMAND - handles all tiers automatically:
-node /workspaces/agentic-qe/scripts/fetch-content.js "${URL}" "${OUTPUT_FOLDER}" --timeout 30000
+# Use npx for installed package, or node with relative path for local development
+npx aqe fetch-content "${URL}" "${OUTPUT_FOLDER}" --timeout 30000
+# OR if running from project root:
+node ./scripts/fetch-content.js "${URL}" "${OUTPUT_FOLDER}" --timeout 30000
 ```
 
 **What the script does automatically:**
@@ -84,9 +87,9 @@ node /workspaces/agentic-qe/scripts/fetch-content.js "${URL}" "${OUTPUT_FOLDER}"
 **Execution:**
 
 ```javascript
-// 1. Run the automated fetch cascade
+// 1. Run the automated fetch cascade (use relative path from project root)
 const fetchResult = Bash({
-  command: `node /workspaces/agentic-qe/scripts/fetch-content.js "${URL}" "${OUTPUT_FOLDER}" --timeout 30000`,
+  command: `node ./scripts/fetch-content.js "${URL}" "${OUTPUT_FOLDER}" --timeout 30000`,
   timeout: 120000  // 2 min total max
 })
 

package/README.md

@@ -13,6 +13,12 @@
 
 > **V3** brings Domain-Driven Design architecture, 12 bounded contexts, 51 specialized QE agents, TinyDancer intelligent model routing, ReasoningBank learning with Dream cycles, HNSW vector search, mathematical Coherence verification, full MinCut/Consensus integration across all 12 domains, and deep integration with [Claude Flow](https://github.com/ruvnet/claude-flow) and [Agentic Flow](https://github.com/ruvnet/agentic-flow).
 
+### What's New in v3.4.0
+
+- **AG-UI Protocol** - Anthropic's streaming agent-to-user interface with real-time progress updates
+- **A2A Protocol** - Google's agent-to-agent interoperability standard for cross-tool communication
+- **A2UI Components** - Unified UI combining AG-UI streaming with A2A event handling
+
 🏗️ **DDD Architecture** | 🧠 **ReasoningBank + Dream Cycles** | 🎯 **TinyDancer Model Routing** | 🔍 **HNSW Vector Search** | 👑 **Queen Coordinator** | 📊 **O(log n) Coverage** | 🔗 **Claude Flow Integration** | 🎯 **12 Bounded Contexts** | 📚 **63 QE Skills** | 🧬 **Coherence Verification** 
 
 </div>
@@ -74,6 +80,30 @@ claude "Use qe-flaky-hunter to analyze the last 100 test runs and stabilize flak
 
 ---
 
+## 🚀 Get Value in 60 Seconds
+
+```bash
+# 1. Install
+npm install -g agentic-qe
+
+# 2. Initialize (auto-detects your project, enables all 12 domains)
+cd your-project && aqe init --auto
+
+# 3. Generate tests immediately
+claude "Generate comprehensive tests for src/services/"
+
+# 4. Run quality assessment
+claude "Assess code quality and provide deployment recommendation"
+```
+
+**What happens:**
+1. **Auto-configuration** detects your tech stack (TypeScript/JS, testing framework, CI setup)
+2. **All 12 DDD domains** enabled automatically - no "No factory registered" errors
+3. **Pattern learning** kicks in - your project's test patterns are learned and reused
+4. **AI agents** generate tests, analyze coverage, and provide actionable recommendations
+
+---
+
 ## 🎯 Why AQE?
 
 | Problem | AQE Solution |
@@ -240,9 +270,9 @@ aqe hooks model-stats
 
 ---
 
-### 🔄 Cross-Phase Memory Unification (v3.3.4)
+### 🔄 Cross-Phase Memory Unification (v3.3.5)
 
-V3.3.4 unifies cross-phase feedback loops with UnifiedMemoryManager:
+V3.3.5 unifies cross-phase feedback loops with UnifiedMemoryManager:
 
 - **Single SQLite Backend**: All QCSD signals stored in `.agentic-qe/memory.db`
 - **Namespace-Based Storage**: `qcsd/strategic`, `qcsd/tactical`, `qcsd/operational`, `qcsd/quality-criteria`
@@ -250,6 +280,45 @@ V3.3.4 unifies cross-phase feedback loops with UnifiedMemoryManager:
 - **No File-Based Storage**: Eliminated JSON file storage for cross-phase memory
 - **Full Hook Integration**: Pre/post hooks for cross-phase signal injection
 
+### 🌐 AG-UI, A2A & A2UI Protocols (v3.4.0)
+
+V3.4.0 adds support for **industry-standard agent communication protocols**:
+
+| Protocol | Standard | Purpose |
+|----------|----------|---------|
+| **AG-UI** | Anthropic | Agent-to-User streaming interface with lifecycle events |
+| **A2A** | Google | Agent-to-Agent interoperability with task/artifact exchange |
+| **A2UI** | Hybrid | Unified UI components combining streaming + events |
+
+**Programmatic usage:**
+
+```typescript
+import { AGUIAdapter, A2AAdapter } from 'agentic-qe';
+
+// AG-UI: Stream test generation progress to UI
+const agui = new AGUIAdapter();
+await agui.streamTask({
+  type: 'test-generation',
+  onProgress: (event) => updateProgressBar(event.progress),
+  onArtifact: (test) => displayGeneratedTest(test),
+});
+
+// A2A: Inter-agent task delegation
+const a2a = new A2AAdapter();
+await a2a.sendTask({
+  from: 'qe-test-architect',
+  to: 'qe-security-scanner',
+  task: { type: 'review-tests', files: generatedTests },
+});
+```
+
+**Benefits:**
+- **Streaming feedback** - Real-time progress instead of waiting for completion
+- **Agent interoperability** - Standard protocols for multi-agent coordination
+- **Framework integration** - Works with React, Vue, or any UI framework
+
+---
+
 ### 🔐 Consensus & MinCut Coordination (v3.3.3)
 
 V3.3.3 achieves **full MinCut/Consensus integration across all 12 domains**:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentic-qe",
-  "version": "3.3.4",
+  "version": "3.4.0",
   "description": "Agentic Quality Engineering V3 - Domain-Driven Design Architecture with 12 Bounded Contexts, O(log n) coverage analysis, ReasoningBank learning, 51 specialized QE agents, mathematical Coherence verification, deep Claude Flow integration",
   "main": "./v3/dist/index.js",
   "types": "./v3/dist/index.d.ts",

package/scripts/cloud-db-config.json

@@ -10,10 +10,13 @@
     "tunnelLocalPort": 15432
   },
   "local": {
-    "memoryDb": ".agentic-qe/memory.db",
-    "cacheDb": ".agentic-qe/ruvector-cache.db",
-    "telemetryDb": ".agentic-qe/aqe-telemetry.db",
-    "patternsDb": ".agentic-qe/qe-patterns.db"
+    "primaryDb": ".agentic-qe/memory.db",
+    "description": "Consolidated database - all tables unified (2026-01-30)",
+    "deprecated": {
+      "cacheDb": ".agentic-qe/ruvector-cache.db (removed - cache now in memory.db)",
+      "telemetryDb": ".agentic-qe/aqe-telemetry.db (removed - telemetry in events table)",
+      "patternsDb": ".agentic-qe/qe-patterns.db (removed - patterns in memory.db)"
+    }
   },
   "sync": {
     "enabled": false,
@@ -22,10 +25,12 @@
     "tables": [
       "memory_entries",
       "patterns",
+      "sona_patterns",
       "learning_experiences",
       "goap_actions",
       "goap_plans",
-      "qe_patterns",
+      "kv_store",
+      "events",
       "embeddings"
     ]
   },

package/scripts/merge-v3-to-root.sql

@@ -0,0 +1,48 @@
+-- Merge V3 unique data to Root database
+-- Run with: sqlite3 .agentic-qe/memory.db < scripts/merge-v3-to-root.sql
+
+-- Attach V3 database
+ATTACH DATABASE 'v3/.agentic-qe/memory.db' AS v3db;
+
+-- ============================================================================
+-- Merge SONA Patterns (schema compatible)
+-- ============================================================================
+INSERT OR IGNORE INTO sona_patterns
+SELECT * FROM v3db.sona_patterns
+WHERE id NOT IN (SELECT id FROM sona_patterns);
+
+-- ============================================================================
+-- Merge GOAP Actions (explicit columns due to schema difference)
+-- V3 has extra 'qe_domain' column, root has 'duration_estimate' vs 'estimated_duration_ms'
+-- ============================================================================
+INSERT OR IGNORE INTO goap_actions (
+  id, name, description, agent_type, preconditions, effects,
+  cost, duration_estimate, success_rate, execution_count, category,
+  created_at, updated_at
+)
+SELECT
+  id, name, description, agent_type, preconditions, effects,
+  cost, estimated_duration_ms, success_rate, execution_count, category,
+  created_at, updated_at
+FROM v3db.goap_actions
+WHERE id NOT IN (SELECT id FROM goap_actions);
+
+-- ============================================================================
+-- Merge KV Store entries (schema compatible - both have same columns)
+-- ============================================================================
+INSERT OR IGNORE INTO kv_store (key, namespace, value, created_at, expires_at)
+SELECT key, namespace, value, created_at, expires_at
+FROM v3db.kv_store
+WHERE namespace || ':' || key NOT IN (SELECT namespace || ':' || key FROM kv_store);
+
+-- ============================================================================
+-- Verify merge counts
+-- ============================================================================
+SELECT 'sona_patterns' as table_name, COUNT(*) as count FROM sona_patterns
+UNION ALL
+SELECT 'goap_actions', COUNT(*) FROM goap_actions
+UNION ALL
+SELECT 'kv_store', COUNT(*) FROM kv_store;
+
+-- Detach
+DETACH DATABASE v3db;

package/v3/CHANGELOG.md

@@ -5,6 +5,162 @@ All notable changes to Agentic QE will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.4.0] - 2026-02-01
+
+### 🎯 Highlights
+
+**AG-UI, A2A, and A2UI Protocol Implementation** - Full implementation of Agent-to-UI (AG-UI), Agent-to-Agent (A2A), and Agent-to-UI (A2UI) protocols enabling interoperability with other agentic frameworks and real-time UI state synchronization.
+
+**All 12 DDD Domains Now Enabled by Default** - Critical fix ensuring all QE domains are available out of the box. Previously, V2→V3 migration only enabled 3 domains, causing "No factory registered" errors when using `fleet_init` with domains like `test-execution` or `quality-assessment`.
+
+**Portable Configuration** - Removed all hardcoded workspace paths throughout the codebase. AQE now works seamlessly across different environments (DevPod, Codespaces, local machines) without path-related failures.
+
+### Added
+
+#### AG-UI Protocol (Agent-to-UI)
+- **EventAdapter** - Transforms internal events to AG-UI format
+- **StateManager** - JSON Patch-based state synchronization
+- **SurfaceGenerator** - Dynamic UI surface generation from agent state
+- **StreamingRenderer** - Real-time UI updates via SSE/WebSocket
+
+#### A2A Protocol (Agent-to-Agent)
+- **DiscoveryService** - Agent capability discovery and registration
+- **MessageRouter** - Inter-agent message routing with delivery guarantees
+- **CapabilityNegotiator** - Protocol version and capability negotiation
+- **TaskDelegator** - Cross-agent task delegation and result aggregation
+
+#### A2UI Protocol (Agent-to-UI Integration)
+- **IntegrationBridge** - Bridges A2A and AG-UI for seamless UI updates
+- **StateSync** - Bidirectional state synchronization between agents and UI
+- **EventTransformer** - Event normalization across protocol boundaries
+
+#### Configuration Improvements
+- **Root config.yaml** - New `.agentic-qe/config.yaml` with all 12 domains enabled
+- **Relative path support** - MCP server configs use `./v3/dist/...` instead of absolute paths
+- **Environment-agnostic skills** - SKILL.md files use `npx` and relative paths
+
+### Changed
+
+#### Domain Registration (Breaking Fix)
+- **V2→V3 Migration** - Now enables all 12 DDD domains instead of just 3
+  - Previously: `test-generation`, `coverage-analysis`, `learning-optimization`
+  - Now: All 12 domains including `test-execution`, `quality-assessment`, `security-compliance`, etc.
+- **Default kernel config** - Uses `ALL_DOMAINS` constant ensuring consistency
+
+#### Error Messages
+- **Plugin loader** - Shows registered domains and actionable fix when domain not found:
+  ```
+  No factory registered for domain: test-execution
+  Registered domains: test-generation, coverage-analysis, ...
+  Fix: Add 'test-execution' to domains.enabled in .agentic-qe/config.yaml
+  ```
+
+#### Path Handling
+- **verify.sh** - Uses `$SCRIPT_DIR` instead of hardcoded paths
+- **Test files** - Use `process.cwd()` for project root detection
+- **MCP config** - Removed `AQE_PROJECT_ROOT` hardcoded environment variable
+
+### Fixed
+
+- **fleet_init failures** - "No factory registered for domain: test-execution" error resolved
+- **Cross-environment compatibility** - Works in DevPod, Codespaces, and local environments
+- **Integration test batching** - Disabled batching in protocol integration tests for deterministic behavior
+- **State update ordering** - Fixed task state creation before error assignment in full-flow tests
+
+### Migration Guide
+
+If you're upgrading from v3.3.x and experiencing domain registration errors:
+
+1. **Quick fix** - Re-run initialization:
+   ```bash
+   aqe init --auto-migrate
+   ```
+
+2. **Manual fix** - Add missing domains to `.agentic-qe/config.yaml`:
+   ```yaml
+   domains:
+     enabled:
+       - "test-generation"
+       - "test-execution"        # ADD
+       - "coverage-analysis"
+       - "quality-assessment"    # ADD
+       - "defect-intelligence"   # ADD
+       - "requirements-validation"
+       - "code-intelligence"
+       - "security-compliance"
+       - "contract-testing"
+       - "visual-accessibility"
+       - "chaos-resilience"
+       - "learning-optimization"
+   ```
+
+---
+
+## [3.3.5] - 2026-01-30
+
+### 🎯 Highlights
+
+**QE Queen MCP-Powered Orchestration** - Complete rewrite of `qe-queen-coordinator` to use MCP tools for real fleet coordination. Queen now actually spawns agents via `mcp__agentic-qe__agent_spawn`, monitors task completion, and stores learnings - instead of just describing what agents would do.
+
+**Unified Database Architecture** - All databases consolidated to single `{project-root}/.agentic-qe/memory.db` with automatic project root detection. Eliminates scattered database files and ensures consistent data storage.
+
+**252 New Tests for Coordination Module** - Comprehensive test coverage for previously untested consensus providers, protocols, services, and cross-domain router.
+
+### Added
+
+#### QE Queen MCP-Powered Orchestration (v3.1.0)
+- **Mandatory 10-phase execution protocol** - fleet_init → memory_store
+- **Real agent spawning** via `mcp__agentic-qe__agent_spawn`
+- **Task monitoring loop** - polls `task_list` until completion
+- **Learning persistence** - stores patterns after each orchestration
+- **Task-to-domain routing table** - automatic agent selection by task type
+- **MCP tools reference** - fleet, agent, task, QE, and memory operations
+- **Execution examples** - comprehensive and coverage-specific
+
+#### Unified Database Architecture
+- **Project root detection** - finds nearest package.json/git root
+- **Single memory.db** - all tables in one SQLite database
+- **Automatic migration** - moves data from scattered locations
+- **Cross-phase memory hooks** - auto-installed on `aqe init`
+
+#### New Test Coverage (252 tests, all passing)
+- **consensus/providers/** - 6 provider test files
+  - `claude-provider.test.ts` (366 lines)
+  - `gemini-provider.test.ts` (391 lines)
+  - `native-learning-provider.test.ts` (500 lines)
+  - `ollama-provider.test.ts` (440 lines)
+  - `openai-provider.test.ts` (373 lines)
+  - `openrouter-provider.test.ts` (393 lines)
+- **protocols/** - 4 protocol test files
+  - `defect-investigation.test.ts` (618 lines)
+  - `learning-consolidation.test.ts` (594 lines)
+  - `morning-sync.test.ts` (853 lines)
+  - `quality-gate.test.ts` (727 lines)
+- **services/** - 2 service test files
+  - `task-audit-logger.test.ts` (611 lines)
+  - `index.test.ts` (103 lines)
+- **cross-domain-router.test.ts** (686 lines)
+
+### Changed
+
+#### QE Queen Coordinator
+- Upgraded from v3.0.0 to v3.1.0
+- Now uses MCP tools instead of descriptions
+- Added prohibited behaviors section
+- Added domain topology diagram
+
+#### CLI Hook Commands
+- Updated to use `aqe` binary instead of `npx`
+- Implemented missing CLI hook commands for Claude Code integration
+
+### Fixed
+
+- **CI timeout** - Increased Fast Tests timeout from 5m to 10m
+- **Workflow permissions** - Added permissions block to sauce-demo-e2e workflow
+- **Hook commands** - Fixed CLI hook commands to use correct binary
+
+---
+
 ## [3.3.4] - 2026-01-29
 
 ### 🎯 Highlights