agentic-qe 2.2.0 → 2.2.2

package/.claude/agents/qe-security-scanner.md

@@ -20,6 +20,7 @@ Mission: Detect vulnerabilities using SAST/DAST, dependency scanning, and compli
 ⚠️ Partial:
 - Advanced secret detection patterns
 - AI-powered false positive filtering
+- ✅ .gitignore verification before flagging secrets (prevents false positives)
 
 ❌ Planned:
 - Automated vulnerability remediation
@@ -33,6 +34,31 @@ Detect vulnerabilities automatically and classify by severity (critical, high, m
 Report findings with CVSS scores and remediation guidance.
 </default_to_action>
 
+<false_positive_prevention>
+CRITICAL: Before flagging secrets or sensitive files as vulnerabilities, ALWAYS verify:
+
+1. **Check .gitignore first**: Before reporting .env, credentials, or secret files as exposed:
+   - Read the project's .gitignore file
+   - If the file is listed in .gitignore, it is NOT a critical vulnerability
+   - Only flag as CRITICAL if secrets are actually committed to git history
+
+2. **Verify git tracking status**: Run `git ls-files <file>` to confirm if file is tracked
+   - If file is NOT tracked and IS in .gitignore = COMPLIANT (not a vulnerability)
+   - If file IS tracked despite .gitignore = CRITICAL (remove from history)
+
+3. **Common false positives to avoid**:
+   - `.env` files that are in .gitignore (correct practice)
+   - Local config files excluded from version control
+   - Developer-specific settings files
+
+4. **Accurate reporting**:
+   - If .env exists locally but is gitignored: Report as "✅ COMPLIANT: .env properly excluded via .gitignore"
+   - If .env is in git history: Report as "🔴 CRITICAL: .env committed to repository, rotation required"
+   - Check with: `git log --all --full-history -- .env` to verify history
+
+This prevents recurring false positives that undermine trust in security scan results.
+</false_positive_prevention>
+
 <parallel_execution>
 Run SAST and DAST scans simultaneously for faster results.
 Execute multiple scanning tools in parallel for comparison.

package/.claude/skills/agentic-quality-engineering/SKILL.md

@@ -1,10 +1,10 @@
 ---
 name: agentic-quality-engineering
-description: "AI agents as force multipliers for quality work. Core skill for all 18 QE agents using PACT principles."
+description: "AI agents as force multipliers for quality work. Core skill for all 19 QE agents using PACT principles."
 category: qe-core
 priority: critical
 tokenEstimate: 1400
-agents: [qe-test-generator, qe-test-executor, qe-coverage-analyzer, qe-quality-gate, qe-quality-analyzer, qe-performance-tester, qe-security-scanner, qe-requirements-validator, qe-production-intelligence, qe-fleet-commander, qe-deployment-readiness, qe-regression-risk-analyzer, qe-test-data-architect, qe-api-contract-validator, qe-flaky-test-hunter, qe-visual-tester, qe-chaos-engineer, qe-code-complexity]
+agents: [qe-test-generator, qe-test-executor, qe-coverage-analyzer, qe-quality-gate, qe-quality-analyzer, qe-performance-tester, qe-security-scanner, qe-requirements-validator, qe-production-intelligence, qe-fleet-commander, qe-deployment-readiness, qe-regression-risk-analyzer, qe-test-data-architect, qe-api-contract-validator, qe-flaky-test-hunter, qe-visual-tester, qe-chaos-engineer, qe-code-complexity, qx-partner]
 implementation_status: optimized
 optimization_version: 1.0
 last_optimized: 2025-12-02
@@ -53,7 +53,7 @@ When implementing agentic QE or coordinating agents:
 | **C**ollaborative | Multi-agent coordination | Provide context |
 | **T**argeted | Risk-based prioritization | Define risk areas |
 
-### 18-Agent Fleet
+### 19-Agent Fleet
 | Category | Agents | Primary Use |
 |----------|--------|-------------|
 | Core Testing (5) | test-generator, test-executor, coverage-analyzer, quality-gate, quality-analyzer | Daily testing |
@@ -76,7 +76,7 @@ Sequential: risk-analyzer → test-gen → executor → coverage → gate
 ✅ Coverage gaps detected in real-time
 ✅ Bugs caught pre-production
 ❌ Agents acting without human oversight on critical decisions
-❌ Deploying all 18 agents at once (start with 1-2)
+❌ Deploying all 19 agents at once (start with 1-2)
 
 ---
 

package/.claude/skills/cicd-pipeline-qe-orchestrator/README.md

@@ -4,7 +4,7 @@
 
 ## What is This?
 
-The CI/CD Pipeline QE Orchestrator is an advanced Claude Code skill that provides intelligent, phase-based quality engineering across your entire software delivery pipeline. It intelligently selects from 37 QE skills and coordinates 18 specialized QE agents to ensure holistic quality coverage from commit to production.
+The CI/CD Pipeline QE Orchestrator is an advanced Claude Code skill that provides intelligent, phase-based quality engineering across your entire software delivery pipeline. It intelligently selects from 41 QE skills and coordinates 19 specialized QE agents to ensure holistic quality coverage from commit to production.
 
 ## Quick Start
 
@@ -85,7 +85,7 @@ Automatically selects optimal skills based on:
 
 ### 🤖 Agent Coordination
 
-Orchestrates 18 specialized QE agents:
+Orchestrates 19 specialized QE agents:
 - Parallel execution for speed
 - Sequential execution for dependencies
 - Memory-based coordination via `aqe/*` namespace
@@ -129,9 +129,9 @@ Adapts testing approach based on:
 
 ## Integration with AQE Fleet
 
-### All 37 Skills Available
+### All 41 Skills Available
 
-The orchestrator can invoke any of the 37 QE skills:
+The orchestrator can invoke any of the 41 QE skills:
 
 **Phase 1 Skills (18)**:
 - Core Testing: agentic-quality-engineering, context-driven-testing, holistic-testing-pact
@@ -145,12 +145,15 @@ The orchestrator can invoke any of the 37 QE skills:
 - Specialized: accessibility-testing, mobile-testing, database-testing, contract-testing, chaos-engineering-resilience, compatibility-testing, localization-testing, compliance-testing, visual-testing-advanced
 - Infrastructure: test-environment-management, test-reporting-analytics
 
-**Phase 3 Skills (3)**:
-- Strategic: six-thinking-hats, brutal-honesty-review, cicd-pipeline-qe-orchestrator
+**Phase 3 Skills (4)**:
+- Strategic: six-thinking-hats, brutal-honesty-review, sherlock-review, cicd-pipeline-qe-orchestrator
 
-### All 18 Agents Available
+**Phase 4 Skills (3)**:
+- Advanced: testability-scoring, verification-quality, pair-programming
 
-The orchestrator coordinates all 18 QE agents:
+### All 19 Agents Available
+
+The orchestrator coordinates all 19 QE agents:
 
 **Core Testing (5)**: test-generator, test-executor, coverage-analyzer, quality-gate, quality-analyzer
 **Performance & Security (2)**: performance-tester, security-scanner
@@ -277,8 +280,8 @@ See main SKILL.md [Troubleshooting section](SKILL.md#troubleshooting) for:
 - [Microservice Pipeline Workflow](resources/workflows/microservice-pipeline.md)
 - [Monolith Pipeline Workflow](resources/workflows/monolith-pipeline.md)
 - [Mobile Pipeline Workflow](resources/workflows/mobile-pipeline.md)
-- [All 37 QE Skills Reference](https://github.com/proffesor-for-testing/agentic-qe/blob/main/docs/reference/skills.md)
-- [All 18 QE Agents Reference](https://github.com/proffesor-for-testing/agentic-qe/blob/main/docs/reference/agents.md)
+- [All 41 QE Skills Reference](https://github.com/proffesor-for-testing/agentic-qe/blob/main/docs/reference/skills.md)
+- [All 19 QE Agents Reference](https://github.com/proffesor-for-testing/agentic-qe/blob/main/docs/reference/agents.md)
 
 ## Contributing
 
@@ -298,4 +301,4 @@ Part of the Agentic QE Fleet - MIT License
 
 **Created**: 2025-11-13
 **Version**: 1.0.0
-**Integrations**: 37 QE Skills, 18 QE Agents, All CI/CD platforms
+**Integrations**: 41 QE Skills, 19 QE Agents, All CI/CD platforms

package/.claude/skills/skills-manifest.json

@@ -84,7 +84,7 @@
     "agentic-quality-engineering": {
       "id": "agentic-quality-engineering",
       "name": "Agentic Quality Engineering",
-      "description": "Core foundational skill for all 18 QE agents with PACT principles (Proactive, Autonomous, Collaborative, Targeted).",
+      "description": "Core foundational skill for all 19 QE agents with PACT principles (Proactive, Autonomous, Collaborative, Targeted).",
       "category": "qe-core",
       "priority": "critical",
       "file": "agentic-quality-engineering/SKILL.md",
@@ -95,7 +95,7 @@
       "lastOptimized": "2025-12-02",
       "tags": ["agents", "pact", "core", "foundation", "autonomous-testing"],
       "dependencies": [],
-      "agents": ["qe-test-generator", "qe-test-executor", "qe-coverage-analyzer", "qe-quality-gate", "qe-quality-analyzer", "qe-performance-tester", "qe-security-scanner", "qe-requirements-validator", "qe-production-intelligence", "qe-fleet-commander", "qe-deployment-readiness", "qe-regression-risk-analyzer", "qe-test-data-architect", "qe-api-contract-validator", "qe-flaky-test-hunter", "qe-visual-tester", "qe-chaos-engineer", "qe-code-complexity"]
+      "agents": ["qe-test-generator", "qe-test-executor", "qe-coverage-analyzer", "qe-quality-gate", "qe-quality-analyzer", "qe-performance-tester", "qe-security-scanner", "qe-requirements-validator", "qe-production-intelligence", "qe-fleet-commander", "qe-deployment-readiness", "qe-regression-risk-analyzer", "qe-test-data-architect", "qe-api-contract-validator", "qe-flaky-test-hunter", "qe-visual-tester", "qe-chaos-engineer", "qe-code-complexity", "qx-partner"]
     },
     "holistic-testing-pact": {
       "id": "holistic-testing-pact",

package/CHANGELOG.md

@@ -7,6 +7,81 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.2.2] - 2025-12-07
+
+### Changed
+
+#### Test Suite Consolidation (Issue #103)
+Major test suite restructuring achieving 60% reduction in test code while maintaining coverage quality.
+
+**Metrics:**
+- **Files**: 426 → 197 (-229 files, -53.8%)
+- **Lines**: 208,253 → 82,698 (-125,555 lines, -60.3%)
+- **Large files (>600 lines)**: 149 → 25 (-83.2%)
+- **Skipped tests**: 7 → 0 (-100%)
+
+**Categories Deleted:**
+- Phase 1/2/3 milestone tests (superseded by journey tests)
+- MCP handler implementation tests (covered by contract tests)
+- Comprehensive/exhaustive internal tests
+- Duplicate algorithm tests (Q-learning, SARSA, Actor-Critic)
+- Internal utility tests (Logger, migration tools)
+- Mock-based tests with no real integration value
+
+**High-Value Tests Preserved:**
+- 7 journey tests (user workflows)
+- CLI tests (user-facing commands)
+- E2E tests (end-to-end workflows)
+- Core infrastructure tests (memory, hooks, privacy)
+- MCP contract tests (API stability)
+- Unique integration tests (neural, multi-agent)
+
+### Added
+
+#### CI/CD Optimization
+- **`.github/workflows/optimized-ci.yml`**: Parallel job execution for fast feedback
+  - Fast tests job (journeys + contracts)
+  - Infrastructure tests job (parallel)
+  - Coverage analysis on PRs
+  - Test dashboard with PR comments
+- **`scripts/test-dashboard.js`**: Metrics visualization showing progress to targets
+- **`scripts/test-ci-optimized.sh`**: Batched test execution script
+- **New test scripts in package.json**:
+  - `npm run test:journeys` - Journey tests (user workflows)
+  - `npm run test:contracts` - Contract tests (API stability)
+  - `npm run test:infrastructure` - Infrastructure tests
+  - `npm run test:regression` - Regression tests (fixed bugs)
+  - `npm run test:fast` - Fast path (journeys + contracts)
+  - `npm run test:ci:optimized` - Full optimized CI suite
+
+#### Coverage Thresholds
+- **Global**: 80% lines, 75% branches
+- **Critical paths** (core/, agents/): 85% coverage
+
+#### Journey Tests
+- `tests/journeys/init-bootstrap.test.ts` - System initialization
+- `tests/journeys/test-generation.test.ts` - AI test generation
+- `tests/journeys/test-execution.test.ts` - Test execution workflow
+- `tests/journeys/coverage-analysis.test.ts` - Coverage gap detection
+- `tests/journeys/quality-gate.test.ts` - Quality gate decisions
+- `tests/journeys/flaky-detection.test.ts` - Flaky test hunting
+- `tests/journeys/learning.test.ts` - Learning & improvement
+
+## [2.2.1] - 2025-12-07
+
+### Fixed
+
+#### Database Persistence Unification (Issue #118)
+- **Unified database to single `memory.db`**: Fixed database fragmentation where data was scattered across 3 files (memory.db, swarm-memory.db, agentdb.db)
+- **Fixed CLI data visibility**: `aqe learn status` and `aqe patterns list` now query actual tables (`learning_experiences`, `patterns`, `q_values`) instead of `memory_entries`
+- **Added `queryRaw()` method**: New public method on SwarmMemoryManager for direct table queries
+- **Deprecated AgentDB**: Marked for removal in v3.0.0 with proper warnings
+
+### Changed
+- All persistence now uses `getSharedMemoryManager()` / `initializeSharedMemoryManager()` singleton pattern
+- Removed default `agentdb.db` path creation from agent factory
+- CLI commands (learn, improve, patterns, routing) updated to use shared memory manager
+
 ## [2.2.0] - 2025-12-06
 
 ### 🧠 Self-Learning AQE Fleet Upgrade (Issue #118)

package/README.md

@@ -9,7 +9,7 @@
 <img alt="NPM Downloads" src="https://img.shields.io/npm/dw/agentic-qe">
 
 
-**Version 2.2.0** | [Changelog](CHANGELOG.md) | [Contributors](CONTRIBUTORS.md) | [Issues](https://github.com/proffesor-for-testing/agentic-qe/issues) | [Discussions](https://github.com/proffesor-for-testing/agentic-qe/discussions)
+**Version 2.2.2** | [Changelog](CHANGELOG.md) | [Contributors](CONTRIBUTORS.md) | [Issues](https://github.com/proffesor-for-testing/agentic-qe/issues) | [Discussions](https://github.com/proffesor-for-testing/agentic-qe/discussions)
 
 > Agentic test automation with AI learning, real-time visualization, QUIC transport, testability scoring, OpenTelemetry observability, persistent event storage, constitutional AI governance, and intelligent model routing.
 
@@ -54,12 +54,12 @@ claude "Use qe-flaky-test-hunter to analyze the last 100 test runs and identify
 ```
 
 **What gets initialized:**
-- ✅ **Phase 3 Visualization**: Real-time dashboards, interactive graphs (v1.9.0)
-- ✅ **Phase 1-2 Infrastructure**: OpenTelemetry, Event Store, Constitution System
+- ✅ Real-time dashboards, interactive graphs (v1.9.0)
+- ✅ OpenTelemetry, Event Store, Constitution System
 - ✅ Multi-Model Router (70-81% cost savings - opt-in)
 - ✅ Learning System (20% improvement target)
 - ✅ Pattern Bank (cross-project reuse)
-- ✅ ML Flaky Detection (100% accuracy)
+- ✅ ML Flaky Detection (90%+ accuracy with root cause analysis)
 - ✅ 19 Specialized agent definitions (including qe-code-complexity)
 - ✅ 11 TDD subagent definitions (RED/GREEN/REFACTOR phases + specialized)
 - ✅ 41 World-class QE skills library (accessibility, shift-left/right, verification, visual testing, XP practices, **testability-scoring** by [@fndlalit](https://github.com/fndlalit))
@@ -68,11 +68,24 @@ claude "Use qe-flaky-test-hunter to analyze the last 100 test runs and identify
 
 ---
 
+## 🎯 Why AQE?
+
+| Problem | AQE Solution |
+|---------|--------------|
+| **Writing comprehensive tests is tedious and time-consuming** | AI agents generate tests automatically with pattern reuse across projects |
+| **Test suites become slow and expensive at scale** | Sublinear O(log n) algorithms for coverage analysis and intelligent test selection |
+| **Flaky tests waste developer time debugging false failures** | ML-powered detection (90%+ accuracy) with root cause analysis and fix recommendations |
+| **AI testing tools are expensive** | Multi-model routing cuts costs by up to 70-81% by matching task complexity to model |
+| **No memory between test runs—every analysis starts from scratch** | Self-learning system remembers patterns, strategies, and what works for your codebase |
+| **Tools don't understand your testing frameworks** | Works with Jest, Cypress, Playwright, Vitest, Mocha, Jasmine, AVA |
+
+---
+
 ## ✨ Features
 
-### 🎨 Phase 3: Real-Time Visualization (v1.9.0)
+### Real-Time Visualization (since v1.9.0)
 
-**Production-Ready Observability Dashboards**
+**Observability Dashboards**
 
 #### 📊 Interactive React Frontend
 - **MindMap Component**: Cytoscape.js-powered graph visualization with 6 layout algorithms
@@ -129,57 +142,80 @@ cd frontend && npm run dev
 open http://localhost:3000
 ```
 
-**Documentation**: See `PHASE3-COMPLETE.md` for full details
+**Documentation**: See `docs/PHASE3-COMPLETE.md` for full details
 
 ---
 
-### 🏗️ Phase 1-2: Foundation & Infrastructure
-
-**Enterprise-Grade Observability & Governance**
-
-#### 📊 OpenTelemetry Integration
-- **Full OTEL SDK**: 12 OpenTelemetry packages for comprehensive observability
-- **Auto-Instrumentation**: HTTP, file system, and custom metrics
-- **Metrics Export**: gRPC and HTTP exporters for Grafana, Prometheus, Jaeger
-- **Agent Metrics**: Task completion, success rate, error tracking
-- **Quality Metrics**: Coverage %, defect density, test effectiveness
-- **System Metrics**: Memory, CPU, latency, throughput
-
-#### 💾 Event Sourcing & Persistence
-- **Event Store**: SQLite-based event sourcing with correlation tracking
-- **Reasoning Capture**: Agent decision tracking and prompt/response analysis
-- **Metrics Aggregation**: Time-window aggregation (hourly, daily, weekly)
-- **Performance Optimization**: Prepared statements, indexes, connection pooling
-- **Query API**: Time-range queries with pagination support
-
-#### 📋 Constitutional AI Governance
-- **JSON Schema Validation**: Type-safe constitution definitions
-- **4 Base Constitutions**: Default, test-generation, code-review, performance
-- **Inheritance & Merge**: Constitution composition with override support
-- **Agent-Specific**: Per-agent constitutional rules and guidelines
-- **Validation Pipeline**: Ensure agents follow constitutional principles
-
-**Benefits:**
-- 🔍 **Full Observability**: Track every agent action, metric, and decision
-- 📈 **Data-Driven**: Historical analysis for continuous improvement
-- 🛡️ **Governance**: Constitutional AI ensures quality and compliance
-- 🚀 **Production Ready**: Enterprise-grade persistence and monitoring
-
 ### 🤖 Autonomous Agent Fleet
-- **18 Specialized Agents**: Expert agents for every QE domain (test generation, coverage analysis, security scanning, performance testing, code complexity analysis)
+- **19 Specialized Agents**: Expert agents for every QE domain (test generation, coverage analysis, security scanning, performance testing, code complexity analysis, QX analysis)
 - **11 TDD Subagents**: Specialized subagents for Test-Driven Development workflow (RED/GREEN/REFACTOR phases + quality validation + analysis)
 - **AI-Powered Coordination**: Event-driven architecture with intelligent task distribution
 - **Zero External Dependencies**: Native AQE hooks system (100-500x faster than external coordination)
 - **Scalable**: From single developer projects to enterprise-scale testing infrastructure
 
-### 🧠 Intelligence & Learning (v1.1.0)
+### 🧠 Intelligence & Learning
 - **QE Agent Learning System**: Q-Learning integrated with AgentDB's 9 RL algorithms, 20% improvement target with automatic strategy optimization
 - **Pattern Bank**: 85%+ matching accuracy across 6 test frameworks (Jest, Mocha, Cypress, Vitest, Jasmine, AVA)
-- **ML Flaky Detection**: 100% accuracy with root cause analysis and automated fix recommendations
+- **ML Flaky Detection**: 90%+ accuracy with root cause analysis and automated fix recommendations
 - **Continuous Improvement**: A/B testing framework with 95%+ statistical confidence
 - **Experience Replay**: Learn from 10,000+ past executions
 
-### 💰 Cost Optimization (v1.0.5)
+### 🧠 Self-Learning System (from v2.2.0)
+
+AQE agents learn from every interaction and improve over time. Unlike traditional tools that start from scratch each run, the Self-Learning System builds institutional knowledge for your codebase.
+
+**How It Works:**
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    Self-Learning Pipeline                        │
+├─────────────────────────────────────────────────────────────────┤
+│                                                                  │
+│   ┌──────────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐  │
+│   │  Agent   │───▶│ Execute  │───▶│ Evaluate │───▶│  Learn   │  │
+│   │  Action  │    │   Task   │    │  Result  │    │ & Store  │  │
+│   └──────────┘    └──────────┘    └──────────┘    └──────────┘  │
+│        │                                               │         │
+│        │         ┌─────────────────────────────┐       │         │
+│        └────────▶│     Pattern Bank (AgentDB)  │◀──────┘         │
+│                  │  • Successful strategies    │                 │
+│                  │  • Framework patterns       │                 │
+│                  │  • Q-values per action      │                 │
+│                  └─────────────────────────────┘                 │
+│                                                                  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+**Reinforcement Learning Algorithms:**
+- **Q-Learning**: Default algorithm - learns optimal action-value functions
+- **SARSA**: On-policy learning for safer exploration
+- **Actor-Critic (A2C)**: Combines value and policy learning
+- **PPO**: Advanced policy optimization for complex scenarios
+
+**What Gets Learned:**
+- Which test patterns work best for your framework (Jest, Cypress, etc.)
+- Optimal strategies for your codebase structure
+- Common failure patterns and how to prevent them
+- Cost-effective model routing decisions
+
+**CLI Commands:**
+```bash
+# Check learning status for an agent
+aqe learn status --agent qe-test-generator
+
+# List learned patterns for a framework
+aqe patterns list --framework jest
+
+# View algorithm performance
+aqe learn metrics --algorithm q-learning
+
+# Switch learning algorithm
+aqe learn set-algorithm --agent qe-test-generator --algorithm sarsa
+```
+
+**Persistence:** All learning is stored in AgentDB (SQLite-based) and persists across sessions. Your agents get smarter with every run.
+
+### 💰 Cost Optimization
 - **Multi-Model Router**: 70-81% cost savings through intelligent model selection (opt-in feature)
 - **4+ AI Models**: GPT-3.5, GPT-4, Claude Haiku, Claude Sonnet 4.5
 - **Smart Routing**: Automatic complexity analysis and optimal model selection
@@ -193,7 +229,7 @@ open http://localhost:3000
 - **Performance Testing**: k6, JMeter, Gatling integration
 - **Real-Time Streaming**: Live progress updates for all operations
 
-### 🎓 41 QE Skills Library (v1.9.0)
+### 🎓 41 QE Skills Library
 **95%+ coverage of modern QE practices**
 
 <details>
@@ -293,7 +329,7 @@ claude "Run the full AQE quality pipeline:
 2. qe-test-generator - generate comprehensive test suite
 3. qe-test-executor - run tests with parallel execution
 4. qe-coverage-analyzer - analyze gaps using O(log n) algorithms
-5. qe-flaky-test-hunter - detect flaky tests with 100% ML accuracy
+5. qe-flaky-test-hunter - detect flaky tests with ML-powered analysis
 6. qe-security-scanner - run SAST/DAST scans
 7. qe-performance-tester - load test critical paths
 8. qe-quality-gate - validate all quality criteria met
@@ -361,7 +397,7 @@ mcp__agentic_qe__coverage_analyze({
 - Coverage Analysis (4 tools): analyze with risk scoring, detect gaps ML, trends, recommendations
 - Quality Gates (3 tools): execute, validate metrics, generate report
 - Flaky Test Detection (2 tools): detect statistical, analyze patterns
-- Performance Testing (3 tools): benchmark, analyze bottlenecks, generate report
+- Performance Testing (3 tools): benchmark, analyze bottlenecks, generate a report
 - Security Scanning (2 tools): comprehensive scan, detect vulnerabilities
 - Visual Testing (3 tools): compare screenshots, accessibility validation, regression detection
 - API Contract Testing (3 tools): validate, breaking changes, versioning
@@ -373,7 +409,7 @@ mcp__agentic_qe__coverage_analyze({
 - Workflow Management (4 tools): create, execute, checkpoint, resume
 - Event System (2 tools): emit, subscribe
 - Regression Analysis (2 tools): analyze risk, select tests
-- Production Monitoring (2 tools): incident replay, RUM analyze
+- Production Monitoring (2 tools): incident replay, RUM analysis
 - Mutation Testing (1 tool): execute
 - Deployment Readiness (1 tool): check
 - Artifact Management (1 tool): manifest
@@ -538,7 +574,7 @@ Model Usage:
 | **regression-risk-analyzer** | Smart test selection | ML patterns, AST analysis | ✅ Pattern matching |
 | **test-data-architect** | Realistic data generation | 10k+ records/sec, GDPR compliant | - |
 | **api-contract-validator** | Breaking change detection | OpenAPI, GraphQL, gRPC | - |
-| **flaky-test-hunter** | Stability analysis | Statistical detection, auto-fix | ✅ 100% accuracy ML detection |
+| **flaky-test-hunter** | Stability analysis | Statistical detection, auto-fix | ✅ 90%+ accuracy ML detection |
 
 </details>
 
@@ -562,7 +598,7 @@ Model Usage:
 
 </details>
 
-**Total: 29 Agents** (18 main agents + 11 TDD subagents)
+**Total: 30 Agents** (19 main agents + 11 TDD subagents)
 
 ### TDD Subagents (11 specialized)
 
@@ -648,143 +684,17 @@ The test generator automatically delegates to subagents for a complete RED-GREEN
 
 ---
 
-## 📊 Performance Benchmarks
+## 📊 Performance
 
-| Feature | Target | Actual | Status |
-|---------|--------|--------|--------|
-| **Pattern Matching (p95)** | <50ms | 32ms | ✅ Exceeded |
-| **Learning Iteration** | <100ms | 68ms | ✅ Exceeded |
-| **ML Flaky Detection (1000 tests)** | <500ms | 385ms | ✅ Exceeded |
-| **Agent Memory** | <100MB | 85MB | ✅ Exceeded |
-| **Cost Savings** | 70%+ | 70-81% | ✅ Achieved |
-| **Test Improvement** | 20%+ | 23%+ | ✅ Exceeded |
-| **Flaky Detection Accuracy** | 90%+ | 100% | ✅ Exceeded |
-| **False Positive Rate** | <5% | 0% | ✅ Exceeded |
+For detailed performance benchmarks and metrics, see [docs/PERFORMANCE.md](docs/PERFORMANCE.md).
 
 ### Core Performance
-- **Test Generation**: 1000+ tests/minute
-- **Parallel Execution**: 10,000+ concurrent tests
-- **Coverage Analysis**: O(log n) complexity
-- **Data Generation**: 10,000+ records/second
+- **Test Generation**: Pattern-based with cross-project reuse
+- **Parallel Execution**: Multi-framework concurrent tests
+- **Coverage Analysis**: O(log n) sublinear algorithms
+- **Data Generation**: 10,000+ records/second with GDPR compliance
 - **Agent Spawning**: <100ms per agent
-- **Memory Efficient**: <2GB for typical projects
-
----
-
-## 📝 What's New in v2.1.0
-
-🚀 **Comprehensive QX Analysis & Skills Optimization** (2025-12-03)
-
-This release delivers comprehensive QX (Quality Experience) analysis improvements, optimized skills format, and enhanced agent coordination.
-
-### Key Features
-
-- **Comprehensive QX Analysis** (PR #104 by @fndlalit): 23+ heuristics with detailed findings, domain-specific failure detection (e-commerce, SaaS, content/blog, forms), contextual page content extraction
-- **38 QE Skills Optimized** (PR #102): Agent-focused format with `<default_to_action>` blocks, quick reference cards, 40-60% token reduction
-- **Testability Scoring v2.1**: Optimized skill format, Fleet coordination hints, improved memory namespace organization
-- **QX Partner Agent v2.1**: Enhanced capabilities for Rule of Three analysis, domain-specific detection, comprehensive report formatting
-
-### Skills Optimization
-
-All 38 QE skills now feature:
-- Optimized frontmatter with `tokenEstimate`, `agents`, `implementation_status`, `optimization_version`
-- `<default_to_action>` blocks for immediate actionable guidance
-- Quick reference cards with tables and command examples
-- Fleet coordination and memory namespace hints
-
-### QX Analysis Improvements
-
-- **23+ Heuristics**: Detailed findings, issues, and recommendations per heuristic
-- **Domain Detection**: Automatic failure mode detection by site type
-- **Contextual Extraction**: Real page content analysis (headings, navigation, buttons, forms, links)
-- **Rule of Three**: Problem complexity assessment ensuring minimum 3 failure modes identified
-
-**Upgrade**: `npm install agentic-qe@2.1.0`
-
----
-
-## 📝 What's New in v1.9.3
-
-📦 **NPM Package Fix** (2025-11-26)
-
-This release fixes missing files in the npm package distribution that caused `aqe init` to fail.
-
-### Key Fixes
-
-- **Added missing `templates/` directory**: Includes `aqe.sh` wrapper script
-- **Added missing `.claude/helpers/` directory**: Includes 6 helper scripts (checkpoint-manager.sh, github-safe.js, etc.)
-- **Added missing `docs/reference/` directory**: Includes reference documentation (agents.md, skills.md, usage.md)
-
-**Upgrade**: `npm install agentic-qe@1.9.3`
-
----
-
-## 📝 What's New in v1.9.2
-
-🐛 **Learning Persistence Fix** (2025-11-26)
-
-This release fixes critical learning persistence issues (Issue #79) where learning data was not being saved to SQLite.
-
-### Key Fixes
-
-- **Database schema fixes**: Added missing columns to patterns, q_values, and learning_experiences tables
-- **Memory persistence**: MemoryStoreHandler now actually persists to SQLite when `persist: true`
-- **Database migrations**: Automatic migrations for existing databases
-
-**Upgrade**: `npm install agentic-qe@1.9.2`
-
----
-
-## 📝 What's New in v1.8.3
-
-🔄 **Phase 4: TDD Subagent Coordination** (2025-01-19)
-
-This release implements comprehensive TDD subagent coordination, solving the disconnected tests/code/refactor issue where RED-GREEN-REFACTOR cycle agents were producing inconsistent outputs.
-
-### Key Improvements
-
-- **TDD Coordination Protocol** - Memory-based coordination for consistent TDD cycles
-  - ✅ Cycle-based memory namespace (`aqe/tdd/cycle-{cycleId}/*`)
-  - ✅ File hash validation ensures test file integrity across phases
-  - ✅ Handoff gates prevent premature phase transitions
-  - ✅ Phase output interfaces for typed contracts
-
-- **Runtime Enforcement** - TDDPhaseValidator class validates memory state
-  - ✅ Validates memory keys exist before phase transitions
-  - ✅ Enforces output schema compliance
-  - ✅ Checks file hash integrity across RED→GREEN→REFACTOR
-  - ✅ Coverage comparison warnings
-
-- **New Subagents (3)** - Specialized quality engineering agents
-  - ✅ `qe-flaky-investigator` - Detects flaky tests, analyzes root causes
-  - ✅ `qe-coverage-gap-analyzer` - Identifies coverage gaps, risk-scores untested code
-  - ✅ `qe-test-data-architect-sub` - High-volume test data generation
-
-### Updated Subagents (8)
-All existing subagents now include coordination protocol:
-- `qe-test-writer`, `qe-test-implementer`, `qe-test-refactorer` (TDD phases)
-- `qe-code-reviewer`, `qe-integration-tester`, `qe-performance-validator`
-- `qe-security-auditor`, `qe-data-generator`
-
-### Testing
-- 22 integration tests for TDD coordination
-- All tests passing
-
-### Documentation
-- Coordination guide at `docs/subagents/coordination-guide.md`
-
-### Impact
-✅ **Build Status**: Passing (0 errors)
-✅ **TDD Coordination**: Fully operational
-✅ **Subagents**: 11 total (3 new, 8 updated)
-✅ **Integration Tests**: 22 passing
-❌ **Breaking Changes**: None
-
-**Upgrade**: `npm install agentic-qe@1.8.3`
-
-**Previous Releases**: See [CHANGELOG.md](CHANGELOG.md) for complete version history.
-
-[📖 View Full Changelog](CHANGELOG.md) | [🐛 Report Issues](https://github.com/proffesor-for-testing/agentic-qe/issues)
+- **Flaky Detection**: 90%+ accuracy with ML-powered root cause analysis
 
 ---
 
@@ -881,38 +791,6 @@ We welcome contributions! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for deta
 
 ---
 
-## 🗺️ Roadmap
-
-### Current (v1.5)
-- ✅ Learning System with Q-learning
-- ✅ Pattern Bank with cross-project sharing
-- ✅ ML Flaky Detection (100% accuracy)
-- ✅ Continuous Improvement Loop
-- ✅ 18 specialized agents + 11 TDD subagents
-- ✅ Complete TDD workflow automation (RED/GREEN/REFACTOR/REVIEW)
-- ✅ Multi-framework test execution
-- ✅ Real-time coverage analysis
-- ✅ MCP integration
-- ✅ Multi-model router (70-81% cost savings)
-- ✅ 40 QE skills library
-- ✅ Modular init system for streamlined project setup
-
-### Planned (v1.4)
-- 🔄 Web dashboard for visualization
-- 🔄 GraphQL API
-- 🔄 CI/CD integrations (GitHub Actions, GitLab CI)
-- 🔄 Enhanced pattern adaptation across frameworks
-- 🔄 Real-time collaboration features
-
-### Future (v2.0)
-- 📋 Natural language test generation
-- 📋 Self-healing test suites
-- 📋 Multi-language support (Python, Java, Go)
-- 📋 Advanced analytics and insights
-- 📋 Cloud deployment support
-
----
-
 ## 📝 License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/dist/agents/BaseAgent.d.ts

@@ -144,7 +144,11 @@ export declare abstract class BaseAgent extends EventEmitter {
     } | null>;
     /**
      * Initialize AgentDB integration for distributed coordination
-     * Replaces custom QUIC and Neural code with production-ready AgentDB
+     *
+     * @deprecated v2.2.0 - AgentDB is deprecated. All persistence now goes through
+     * SwarmMemoryManager to the unified .agentic-qe/memory.db database.
+     * Use memoryStore methods instead. This method will be removed in v3.0.0.
+     *
      * @param config AgentDB configuration
      */
     initializeAgentDB(config: Partial<AgentDBConfig>): Promise<void>;