agentic-qe 2.1.2 → 2.2.1

package/README.md

@@ -9,7 +9,7 @@
 <img alt="NPM Downloads" src="https://img.shields.io/npm/dw/agentic-qe">
 
 
-**Version 2.1.1** | [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.1** | [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>;

package/dist/agents/BaseAgent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BaseAgent.d.ts","sourceRoot":"","sources":["../../src/agents/BaseAgent.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,OAAO,EACL,OAAO,EACP,WAAW,IAAI,SAAS,EACxB,WAAW,EACX,YAAY,EACZ,eAAe,EAEf,YAAY,EACZ,WAAW,EACX,MAAM,EACN,cAAc,EAGd,WAAW,EACX,YAAY,EACZ,aAAa,EACd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,aAAa,EAAwB,MAAM,+BAA+B,CAAC;AACpG,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAEjE,MAAM,WAAW,eAAe;IAC9B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,OAAO,EAAE,YAAY,CAAC;IACtB,WAAW,EAAE,WAAW,CAAC;IACzB,QAAQ,EAAE,YAAY,CAAC;IACvB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACzC,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IAGvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,gBAAgB,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;CAC7D;AAED,8BAAsB,SAAU,SAAQ,YAAY;IAClD,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IACpC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC9D,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IACzC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAC5C,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAC1C,SAAS,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC;IACvC,SAAS,CAAC,WAAW,EAAE,uBAAuB,CAAC;IAC/C,SAAS,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAClD,SAAS,CAAC,cAAc,CAAC,EAAE,cAAc,CAAC;IAC1C,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IAC3C,OAAO,CAAC,cAAc,CAAC,CAA0B;IACjD,SAAS,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IACnC,SAAS,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACjD,SAAS,CAAC,kBAAkB,EAAE;QAC5B,cAAc,EAAE,MAAM,CAAC;QACvB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,IAAI,CAAC;KACpB,CAKC;IACF,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,OAAO,CAAC,mBAAmB,CAAC,CAAgB;IAG5C,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,qBAAqB,CAAC;IAC3D,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,gBAAgB,CAAC;IACjD,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;gBAEzC,MAAM,EAAE,eAAe;IAmEnC;;;OAGG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA+FxC;;OAEG;IACU,WAAW,CAAC,UAAU,EAAE,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC;IAsDlE;;OAEG;IACU,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IA4CvC;;OAEG;IACI,SAAS,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,WAAW,CAAC;QACpB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,kBAAkB,EAAE;YAClB,cAAc,EAAE,MAAM,CAAC;YACvB,oBAAoB,EAAE,MAAM,CAAC;YAC7B,UAAU,EAAE,MAAM,CAAC;YACnB,YAAY,EAAE,IAAI,CAAC;SACpB,CAAC;KACH;IAcD;;;;OAIG;IACU,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAwBvF;;;;OAIG;IACU,YAAY,CAAC,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjE;;;OAGG;IACU,YAAY,CAAC,CAAC,GAAG,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAiB1F;;;OAGG;IACH,SAAS,CAAC,gBAAgB,CAAC,SAAS,EAAE,WAAW,GAAG,IAAI;IASxD;;OAEG;IACI,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;IAIrD;;OAEG;IACI,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIzE;;OAEG;IACI,eAAe,IAAI,eAAe,EAAE;IAI3C;;OAEG;IACH,SAAS,CAAC,kBAAkB,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAQ/D;;OAEG;IACH,SAAS,CAAC,oBAAoB,CAAC,YAAY,EAAE,eAAe,EAAE,GAAG,IAAI;IAMrE;;OAEG;IACU,iBAAiB,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC;IAUtF;;OAEG;IACU,kBAAkB;IAK/B;;OAEG;IACU,iBAAiB;;;;;;IAW9B;;;;OAIG;IACU,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B7E;;OAEG;IACU,gBAAgB;;;;;;;;;IAiB7B;;OAEG;IACI,UAAU,IAAI,OAAO;IAI5B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAQrB;;OAEG;IACU,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAanC;;;OAGG;IACU,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC;;OAEG;IACU,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBpD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAExD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAE1D;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAEjD;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3C;;OAEG;IACH,SAAS,CAAC,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;IAIvE;;OAEG;IACH,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,GAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAqB,GAAG,IAAI;IAc/G;;;OAGG;cACa,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB3E;;OAEG;cACa,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASjF;;OAEG;cACa,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IASzD;;OAEG;cACa,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASvF;;OAEG;cACa,oBAAoB,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC;IAarF;;;;;OAKG;cACa,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAkG3D;;;;;OAKG;cACa,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAyJ7D;;;;;OAKG;cACa,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;YA2GjD,WAAW;IAezB,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,sBAAsB;IAc9B,OAAO,CAAC,wBAAwB;YAelB,eAAe;YAQf,YAAY;YAYZ,SAAS;YAWT,YAAY;IAa1B,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,eAAe;IAIvB,OAAO,CAAC,iBAAiB;CAK1B;AAMD,MAAM,WAAW,YAAY;IAC3B,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1E,iBAAiB,IAAI,SAAS,EAAE,CAAC;IACjC,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,EAAE,CAAC;CACrD;AAED,8BAAsB,gBAAiB,YAAW,YAAY;IAC5D,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,CAAC;IAClF,QAAQ,CAAC,iBAAiB,IAAI,SAAS,EAAE;IACzC,QAAQ,CAAC,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,eAAe,EAAE;CAC7D"}
+{"version":3,"file":"BaseAgent.d.ts","sourceRoot":"","sources":["../../src/agents/BaseAgent.ts"],"names":[],"mappings":"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"}

package/dist/agents/BaseAgent.js

@@ -39,22 +39,31 @@ class BaseAgent extends events_1.EventEmitter {
         this.eventBus = config.eventBus;
         this.enableLearning = config.enableLearning ?? true; // Changed: Default to true for all agents
         this.learningConfig = config.learningConfig;
-        // Build AgentDB config from either agentDBConfig or shorthand properties
+        // DEPRECATED (v2.2.0): AgentDB configuration
+        // All persistence now goes through SwarmMemoryManager to .agentic-qe/memory.db
+        // AgentDB is kept for backward compatibility but should NOT be used for new code.
+        // LearningEngine handles all learning/pattern storage via memoryStore.
         if (config.agentDBConfig) {
+            console.warn(`[${config.type}] AgentDB is DEPRECATED. All persistence should use SwarmMemoryManager (memory.db). ` +
+                `AgentDB will be removed in v3.0.0.`);
             this.agentDBConfig = config.agentDBConfig;
         }
         else if (config.agentDBPath || config.enableQUICSync) {
-            this.agentDBConfig = {
-                // Updated default path to use .agentic-qe directory for consolidation
-                dbPath: config.agentDBPath || '.agentic-qe/agentdb.db',
-                enableQUICSync: config.enableQUICSync || false,
-                syncPort: config.syncPort || 4433,
-                syncPeers: config.syncPeers || [],
-                enableLearning: config.enableLearning || false,
-                enableReasoning: true,
-                cacheSize: 1000,
-                quantizationType: config.quantizationType || 'scalar',
-            };
+            console.warn(`[${config.type}] AgentDB paths are DEPRECATED. All persistence now uses memory.db via SwarmMemoryManager.`);
+            // Do NOT create agentDBConfig by default - let memoryStore handle everything
+            // Only create if explicitly requested with a custom path
+            if (config.agentDBPath) {
+                this.agentDBConfig = {
+                    dbPath: config.agentDBPath, // Use explicit path only, no default
+                    enableQUICSync: config.enableQUICSync || false,
+                    syncPort: config.syncPort || 4433,
+                    syncPeers: config.syncPeers || [],
+                    enableLearning: config.enableLearning || false,
+                    enableReasoning: true,
+                    cacheSize: 1000,
+                    quantizationType: config.quantizationType || 'scalar',
+                };
+            }
         }
         // Initialize verification hook manager with type-safe adapter
         // MemoryStoreAdapter bridges MemoryStore interface to SwarmMemoryManager
@@ -127,8 +136,9 @@ class BaseAgent extends events_1.EventEmitter {
                         this.performanceTracker = new PerformanceTracker_1.PerformanceTracker(this.agentId.id, this.memoryStore);
                         await this.performanceTracker.initialize();
                         // Initialize learning engine for Q-learning
-                        // Architecture: LearningEngine uses SwarmMemoryManager for all persistence
-                        // No direct database dependency - memoryStore handles AgentDB coordination
+                        // ARCHITECTURE (v2.2.0): LearningEngine uses SwarmMemoryManager for ALL persistence
+                        // All data (experiences, patterns, Q-values) goes to unified .agentic-qe/memory.db
+                        // No direct database dependency - memoryStore handles all coordination
                         this.learningEngine = new LearningEngine_1.LearningEngine(this.agentId.id, this.memoryStore, this.learningConfig);
                         await this.learningEngine.initialize();
                     }
@@ -217,9 +227,10 @@ class BaseAgent extends events_1.EventEmitter {
                     await this.executeHook('pre-termination');
                     // Flush learning data before termination
                     if (this.learningEngine && this.learningEngine.isEnabled()) {
-                        // LearningEngine persists data via SwarmMemoryManager (which uses AgentDB)
+                        // ARCHITECTURE (v2.2.0): LearningEngine persists to unified memory.db
+                        // All data goes through SwarmMemoryManager to .agentic-qe/memory.db
                         // No explicit flush needed - memoryStore handles persistence automatically
-                        console.info(`[${this.agentId.id}] Learning data persisted via memoryStore (SwarmMemoryManager -> AgentDB)`);
+                        console.info(`[${this.agentId.id}] Learning data persisted via SwarmMemoryManager (memory.db)`);
                     }
                     // Close AgentDB if enabled
                     if (this.agentDB) {
@@ -402,7 +413,11 @@ class BaseAgent extends events_1.EventEmitter {
     }
     /**
      * 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
      */
     async initializeAgentDB(config) {