agentic-qe 2.1.0 → 2.1.2

package/CHANGELOG.md

@@ -7,6 +7,134 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.1.2] - 2025-12-06
+
+### 🚀 MCP Tools Optimization - 87% Context Reduction (Issue #115)
+
+This release delivers major MCP tool optimization with hierarchical lazy loading, achieving 87% context reduction for AI interactions. Legacy tools have been removed and consolidated into modern Phase 3 domain tools.
+
+### Added
+
+#### Hierarchical Tool Loading System
+- **`tools_discover` meta-tool**: Explore available tool domains without loading them
+- **`tools_load_domain` meta-tool**: On-demand domain loading for specific tool categories
+- **`LazyToolLoader` class** (`src/mcp/lazy-loader.ts`): Dynamic tool management with usage tracking
+- **Domain-based categorization** (`src/mcp/tool-categories.ts`):
+  - Core tools (always loaded): fleet management, memory, workflow
+  - Domain tools: coverage, flaky, performance, security, visual, quality-gates
+  - Specialized tools: api-contract, test-data, regression, requirements, code-quality
+- **Keyword-based auto-detection**: Intelligent domain loading from message content
+- **Usage analytics**: Track tool and domain usage for optimization insights
+
+#### Documentation
+- **Migration guide**: `docs/migration/issue-115-tool-optimization.md`
+- **Updated agent reference**: `docs/reference/agents.md` with tool discovery system
+- **Updated usage guide**: `docs/reference/usage.md` with lazy loading examples
+
+### Changed
+
+#### MCP Tools Reduction
+- **Tool count**: 102 → 84 tools (18% reduction)
+- **Context reduction**: 87% via lazy loading (only core tools loaded initially)
+- **Description optimization**: 27% character reduction across tool descriptions
+- **Consolidated duplicates**: Multiple tools merged into unified versions
+
+#### Tool Consolidation
+- Coverage tools: 7 → 4 tools (merged into Phase 3 domain tools)
+- Security tools: 5 → 3 tools (consolidated into comprehensive scanner)
+- Quality gate tools: 5 → 3 tools (merged into `qe_qualitygate_*`)
+- Performance tools: benchmark tools merged into `performance_run_benchmark`
+
+### Deprecated
+
+The following tools now show console warnings and will be removed in v3.0.0:
+- `flaky_test_detect` → use `flaky_detect_statistical` or `flaky_analyze_patterns`
+- `coverage_analyze_sublinear` → use `coverage_analyze_with_risk_scoring`
+- `coverage_gaps_detect` → use `coverage_detect_gaps_ml`
+- `performance_monitor_realtime` → use `performance_analyze_bottlenecks`
+
+### Removed
+
+#### 17 Legacy Handler Files (10,433 lines of code removed)
+- `test-generate.ts` → use `test_generate_enhanced`
+- `quality-analyze.ts` → use `qe_qualitygate_evaluate`
+- `predict-defects.ts` → use `predict_defects_ai`
+- `optimize-tests.ts` → use `test_optimize_sublinear`
+- `quality/quality-gate-execute.ts` → use `qe_qualitygate_evaluate`
+- `quality/quality-validate-metrics.ts` → use `qe_qualitygate_validate_metrics`
+- `quality/quality-risk-assess.ts` → use `qe_qualitygate_assess_risk`
+- `quality/quality-decision-make.ts` → merged into `qe_qualitygate_evaluate`
+- `quality/quality-policy-check.ts` → merged into `qe_qualitygate_evaluate`
+- `prediction/regression-risk-analyze.ts` → use `qe_regression_analyze_risk`
+- `analysis/performanceBenchmarkRun.ts` → use `performance_run_benchmark`
+- `analysis/performance-benchmark-run-handler.ts`
+- `advanced/requirements-validate.ts` → use `qe_requirements_validate`
+- `advanced/requirements-generate-bdd.ts` → use `qe_requirements_bdd`
+- `security/validate-auth.ts` → use `qe_security_detect_vulnerabilities`
+- `security/check-authz.ts` → use `qe_security_detect_vulnerabilities`
+- `security/scan-dependencies.ts` → use `qe_security_detect_vulnerabilities`
+
+### Fixed
+
+- Cleaned up orphaned handler exports in index files
+- Fixed server.ts imports for removed handlers
+- Removed empty `handlers/quality/` directory
+
+### Security
+
+- Bumped `jws` dependency to address security vulnerability (PR #114)
+
+### Performance
+
+| Metric | Before | After | Improvement |
+|--------|--------|-------|-------------|
+| Tool definitions | 102 | 84 | 18% reduction |
+| Initial context | All tools | Core only | 87% reduction |
+| Lines of code | +10,433 | -10,433 | Cleaner codebase |
+
+### References
+
+- Issue: [#115 - MCP Tools Context Optimization](https://github.com/proffesor-for-testing/agentic-qe/issues/115)
+- Follow-up: [#116 - Continued Optimization](https://github.com/proffesor-for-testing/agentic-qe/issues/116)
+
+## [2.1.1] - 2025-12-04
+
+### 🎯 QX Enhancements, Memory Leak Fixes & Security Improvements
+
+This release builds on v2.1.0 with significant QX Partner Agent enhancements, critical memory leak fixes, and security improvements.
+
+### Added
+
+#### QX Partner Agent Enhancements (PR #110 by @fndlalit)
+- **Creativity Analysis**: Domain-inspired testing approaches from philosophy, medicine, e-commerce, social science, and gaming
+- **Design Analysis**: Three dimensions - Exactness & Clarity, Intuitive Design, Counter-intuitive Design
+- **Enhanced Scoring**: Now includes creativity (15%) and design (15%) in overall QX score
+- **Methodology Section**: New HTML report sections explaining QX concepts
+
+#### Memory Adapters (Issue #109)
+- **ReflexionMemoryAdapter**: Flaky test prediction with experience replay (410 lines)
+- **SparseVectorSearch**: Hybrid BM25/vector search for semantic retrieval (174 lines)
+- **TieredCompression**: 85% memory reduction with adaptive compression (328 lines)
+
+#### Community Contribution
+- **testability-scoring skill**: Automated testability assessment using 10 principles (by @fndlalit)
+
+### Fixed
+
+#### Memory Leak Fixes (Issue #112 P0)
+- **Chaos handler intervals**: Lazy initialization with `ensureCleanupInterval()`
+- **Process blocking**: Added `.unref()` to prevent intervals from blocking exit
+- **Test cleanup**: Added `shutdown()` exports for clean teardown
+
+#### Security Improvements
+- **Workflow permissions**: Explicit permissions in migration-validation.yml
+- **CI pipeline**: jest-junit reporter configuration, FleetManager.database.test.ts flaky tests
+
+### Changed
+- Updated skills count from 38 to 39 (added testability-scoring)
+- State files now in .gitignore to prevent merge conflicts
+- Cleaned up working files from root folder
+
 ## [2.1.0] - 2025-12-03
 
 ### 🚀 Comprehensive QX Analysis & Skills Optimization

package/README.md

@@ -9,7 +9,7 @@
 <img alt="NPM Downloads" src="https://img.shields.io/npm/dw/agentic-qe">
 
 
-**Version 2.1.0** | [Changelog](CHANGELOG.md) | [Issues](https://github.com/proffesor-for-testing/agentic-qe/issues) | [Discussions](https://github.com/proffesor-for-testing/agentic-qe/discussions)
+**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)
 
 > 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.
 
@@ -354,26 +354,25 @@ mcp__agentic_qe__coverage_analyze({
 })
 ```
 
-**All 102 MCP Tools Available:**
+**All 84 MCP Tools Available:**
 - Fleet Management (9 tools): init, spawn, status, coordinate, orchestrate
-- Test Generation (4 tools): generate, enhanced, unit, integration  
+- Test Generation (2 tools): generate enhanced, execute
 - Test Execution (3 tools): execute, parallel, stream
-- Coverage Analysis (6 tools): analyze, gaps, trends, risk scoring, ML detection, recommendations
-- Quality Gates (5 tools): execute, validate, assess risk, policy check, generate report
-- Flaky Test Detection (3 tools): detect, analyze patterns, auto-stabilize
-- Performance Testing (4 tools): benchmark, monitor, analyze bottlenecks, generate report
-- Security Scanning (5 tools): comprehensive scan, vulnerabilities, auth validation, authz check, dependencies
+- 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
+- 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
 - Test Data Management (3 tools): generate, mask, analyze schema
-- Requirements Engineering (2 tools): validate, generate BDD
 - Code Quality (2 tools): complexity analysis, metrics
 - Memory & Collaboration (5 tools): store, retrieve, query, share, backup
 - Blackboard System (2 tools): post, read
 - Consensus Mechanisms (2 tools): propose, vote
 - Workflow Management (4 tools): create, execute, checkpoint, resume
 - Event System (2 tools): emit, subscribe
-- Regression Analysis (2 tools): risk analyze, select tests
+- Regression Analysis (2 tools): analyze risk, select tests
 - Production Monitoring (2 tools): incident replay, RUM analyze
 - Mutation Testing (1 tool): execute
 - Deployment Readiness (1 tool): check
@@ -920,6 +919,33 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 ---
 
+## 👥 Contributors
+
+Thanks to all the amazing people who have contributed to Agentic QE Fleet!
+
+<!-- ALL-CONTRIBUTORS-LIST:START -->
+| <img src="https://github.com/proffesor-for-testing.png" width="60" style="border-radius:50%"/><br/>**[@proffesor-for-testing](https://github.com/proffesor-for-testing)**<br/>Project Lead | <img src="https://github.com/fndlalit.png" width="60" style="border-radius:50%"/><br/>**[@fndlalit](https://github.com/fndlalit)**<br/>QX Partner, Testability | <img src="https://github.com/shaal.png" width="60" style="border-radius:50%"/><br/>**[@shaal](https://github.com/shaal)**<br/>Core Development | <img src="https://github.com/mondweep.png" width="60" style="border-radius:50%"/><br/>**[@mondweep](https://github.com/mondweep)**<br/>Architecture |
+|:---:|:---:|:---:|:---:|
+<!-- ALL-CONTRIBUTORS-LIST:END -->
+
+[View all contributors](CONTRIBUTORS.md) | [Become a contributor](CONTRIBUTING.md)
+
+---
+
+## 💖 Support the Project
+
+If you find Agentic QE Fleet valuable, consider supporting its development:
+
+| | Monthly | Annual (Save $10) |
+|---|:---:|:---:|
+| **Price** | $5/month | $50/year |
+| **Benefits** | Sponsor recognition, Priority support | All monthly + Featured in README, Roadmap input |
+| **Subscribe** | [**Monthly**](https://www.paypal.com/webapps/billing/plans/subscribe?plan_id=P-88G03706DU8150205NEYZZAY) | [**Annual**](https://www.paypal.com/webapps/billing/plans/subscribe?plan_id=P-39189175UE6623540NEYZ2CI) |
+
+[View sponsorship details](FUNDING.md)
+
+---
+
 ## 🙏 Acknowledgments
 
 - Built with TypeScript, Node.js, and better-sqlite3
@@ -933,6 +959,6 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file
 
 **Made with ❤️ by the Agentic QE Team**
 
-[⭐ Star us on GitHub](https://github.com/proffesor-for-testing/agentic-qe) • [🐦 Follow on Twitter](https://twitter.com/agenticqe)
+[⭐ Star us on GitHub](https://github.com/proffesor-for-testing/agentic-qe) | [💖 Sponsor](FUNDING.md) | [👥 Contributors](CONTRIBUTORS.md)
 
 </div>

package/dist/agents/QXPartnerAgent.d.ts

@@ -62,6 +62,38 @@ export declare class QXPartnerAgent extends BaseAgent {
      * Perform comprehensive QX analysis
      */
     private performFullQXAnalysis;
+    /**
+     * Generate HTML report from QX analysis
+     */
+    private generateHTMLReport;
+    /**
+     * Generate HTML content for the report
+     */
+    private generateHTMLContent;
+    /**
+     * Get CSS styles for the report
+     */
+    private getReportStyles;
+    /**
+     * Escape HTML special characters
+     */
+    private escapeHtml;
+    /**
+     * Format heuristic name for display
+     */
+    private formatHeuristicName;
+    /**
+     * Get color based on score
+     */
+    private getScoreColor;
+    /**
+     * Get score interpretation
+     */
+    private getScoreInterpretation;
+    /**
+     * Launch report in default browser
+     */
+    private launchReportInBrowser;
     /**
      * Collect QX context from target using Playwright
      */
@@ -82,6 +114,14 @@ export declare class QXPartnerAgent extends BaseAgent {
      * Analyze business needs
      */
     private analyzeBusinessNeeds;
+    /**
+     * Analyze Creativity - Drawing inspiration from diverse domains
+     */
+    private analyzeCreativity;
+    /**
+     * Analyze Design - Exactness, Intuitive, and Counter-intuitive Design
+     */
+    private analyzeDesign;
     /**
      * Detect oracle problems from analysis context
      */
@@ -98,7 +138,6 @@ export declare class QXPartnerAgent extends BaseAgent {
      * Generate QX recommendations
      */
     private generateRecommendations;
-    private formatHeuristicName;
     /**
      * Calculate overall QX score
      */

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

@@ -1 +1 @@
-{"version":3,"file":"QXPartnerAgent.d.ts","sourceRoot":"","sources":["../../src/agents/QXPartnerAgent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,SAAS,EAAmB,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,MAAM,EAAgC,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAC3F,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAEL,eAAe,EAahB,MAAM,aAAa,CAAC;AAGrB,UAAU,MAAM;IACd,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAiBD,qBAAa,cAAe,SAAQ,SAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAuB;IACxD,OAAO,CAAC,gBAAgB,CAAC,CAAqB;IAC9C,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,cAAc,CAAC,CAAiB;IACxC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,IAAI,CAAqB;gBAErB,MAAM,EAAE,eAAe,GAAG;QAAE,OAAO,EAAE,YAAY,CAAC;QAAC,WAAW,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,YAAY,CAAA;KAAE;IAsCjH;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAmCrC;;OAEG;cACa,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCrD;;OAEG;cACa,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA+C9C;;OAEG;cACa,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAiCxC;;OAEG;cACa,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAqC3D;;OAEG;YACW,qBAAqB;IAiFnC;;OAEG;YACW,gBAAgB;IAqM9B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IA4HpC;;OAEG;YACW,cAAc;IA0H5B;;OAEG;YACW,gBAAgB;IAsG9B;;OAEG;YACW,oBAAoB;IA4FlC;;OAEG;YACW,+BAA+B;IAY7C;;OAEG;YACW,aAAa;IAQ3B;;OAEG;YACW,kBAAkB;IAahC;;OAEG;YACW,uBAAuB;IAgKrC,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAgC/B;;OAEG;IACH,OAAO,CAAC,YAAY;IAQpB;;OAEG;YACW,oBAAoB;IASlC;;OAEG;YACW,0BAA0B;IAkBxC,OAAO,CAAC,wBAAwB;IAWhC;;OAEG;YACW,qBAAqB;IAOnC;;OAEG;YACW,sBAAsB;IAiBpC;;OAEG;YACW,yBAAyB;IAKvC;;OAEG;YACW,2BAA2B;YA2B3B,sCAAsC;YAKtC,0BAA0B;YAY1B,+BAA+B;YAW/B,WAAW;YASX,kBAAkB;YAQlB,sBAAsB;YAQtB,0BAA0B;cASxB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;cAIpC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;CAGtD"}
+{"version":3,"file":"QXPartnerAgent.d.ts","sourceRoot":"","sources":["../../src/agents/QXPartnerAgent.ts"],"names":[],"mappings":"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"}