agentic-qe 2.1.0 → 2.1.2

package/dist/utils/IntervalRegistry.js

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * Global Interval Registry for Memory Leak Prevention
+ *
+ * Provides a centralized registry for tracking intervals that need cleanup.
+ * This is especially important for:
+ * - Module-level intervals that persist across tests
+ * - Intervals in singleton instances
+ * - Cleanup during graceful shutdown
+ *
+ * Usage:
+ * ```typescript
+ * import { IntervalRegistry } from './utils/IntervalRegistry';
+ *
+ * // Register an interval for cleanup
+ * const intervalId = setInterval(fn, 1000);
+ * IntervalRegistry.register('my-feature', intervalId);
+ *
+ * // Register with shutdown callback
+ * IntervalRegistry.registerWithShutdown('my-feature', {
+ *   interval: intervalId,
+ *   shutdown: async () => { ... }
+ * });
+ *
+ * // Cleanup specific feature
+ * await IntervalRegistry.shutdown('my-feature');
+ *
+ * // Cleanup all (for tests or process exit)
+ * await IntervalRegistry.shutdownAll();
+ * ```
+ *
+ * @module utils/IntervalRegistry
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shutdownChaosFailure = exports.shutdownChaosLatency = exports.IntervalRegistry = void 0;
+/**
+ * Global registry for tracking intervals that need cleanup
+ */
+class IntervalRegistryClass {
+    constructor() {
+        this.registry = new Map();
+        this.shutdownCallbacks = new Map();
+    }
+    /**
+     * Register an interval for later cleanup
+     *
+     * @param feature - Feature/module name for grouping
+     * @param interval - The interval handle from setInterval
+     */
+    register(feature, interval) {
+        const entry = {
+            interval,
+            registeredAt: Date.now(),
+        };
+        const existing = this.registry.get(feature) ?? [];
+        existing.push(entry);
+        this.registry.set(feature, existing);
+    }
+    /**
+     * Register an interval with a custom shutdown callback
+     *
+     * @param feature - Feature/module name for grouping
+     * @param config - Interval and optional shutdown callback
+     */
+    registerWithShutdown(feature, config) {
+        const entry = {
+            interval: config.interval,
+            shutdown: config.shutdown,
+            registeredAt: Date.now(),
+        };
+        const existing = this.registry.get(feature) ?? [];
+        existing.push(entry);
+        this.registry.set(feature, existing);
+    }
+    /**
+     * Register a shutdown callback for a feature
+     * This is called even if no intervals are registered
+     *
+     * @param feature - Feature/module name
+     * @param callback - Shutdown callback
+     */
+    registerShutdownCallback(feature, callback) {
+        this.shutdownCallbacks.set(feature, callback);
+    }
+    /**
+     * Unregister a specific interval
+     *
+     * @param feature - Feature name
+     * @param interval - The interval to unregister
+     */
+    unregister(feature, interval) {
+        const entries = this.registry.get(feature);
+        if (entries) {
+            const filtered = entries.filter(e => e.interval !== interval);
+            if (filtered.length === 0) {
+                this.registry.delete(feature);
+            }
+            else {
+                this.registry.set(feature, filtered);
+            }
+        }
+    }
+    /**
+     * Shutdown all intervals for a specific feature
+     *
+     * @param feature - Feature name to shutdown
+     */
+    async shutdown(feature) {
+        const entries = this.registry.get(feature);
+        if (entries) {
+            for (const entry of entries) {
+                clearInterval(entry.interval);
+                if (entry.shutdown) {
+                    try {
+                        await Promise.resolve(entry.shutdown());
+                    }
+                    catch (error) {
+                        console.warn(`[IntervalRegistry] Shutdown error for ${feature}:`, error);
+                    }
+                }
+            }
+            this.registry.delete(feature);
+        }
+        // Call feature shutdown callback if registered
+        const callback = this.shutdownCallbacks.get(feature);
+        if (callback) {
+            try {
+                await Promise.resolve(callback());
+            }
+            catch (error) {
+                console.warn(`[IntervalRegistry] Callback error for ${feature}:`, error);
+            }
+            this.shutdownCallbacks.delete(feature);
+        }
+    }
+    /**
+     * Shutdown all registered intervals
+     * Typically called during test teardown or process exit
+     */
+    async shutdownAll() {
+        const features = Array.from(this.registry.keys());
+        const callbacks = Array.from(this.shutdownCallbacks.keys());
+        // Combine unique features
+        const allFeatures = [...new Set([...features, ...callbacks])];
+        await Promise.all(allFeatures.map(feature => this.shutdown(feature).catch(error => {
+            console.warn(`[IntervalRegistry] Shutdown error for ${feature}:`, error);
+        })));
+    }
+    /**
+     * Get statistics about registered intervals
+     */
+    getStats() {
+        const byFeature = {};
+        let total = 0;
+        for (const [feature, entries] of this.registry.entries()) {
+            byFeature[feature] = entries.length;
+            total += entries.length;
+        }
+        return {
+            totalIntervals: total,
+            features: Array.from(this.registry.keys()),
+            byFeature,
+        };
+    }
+    /**
+     * Clear all registrations without calling shutdown
+     * Use with caution - primarily for testing
+     */
+    clear() {
+        for (const entries of this.registry.values()) {
+            for (const entry of entries) {
+                clearInterval(entry.interval);
+            }
+        }
+        this.registry.clear();
+        this.shutdownCallbacks.clear();
+    }
+}
+/**
+ * Singleton instance of the interval registry
+ */
+exports.IntervalRegistry = new IntervalRegistryClass();
+/**
+ * Export shutdown functions for chaos handlers and other modules
+ */
+var chaos_inject_latency_1 = require("../mcp/handlers/chaos/chaos-inject-latency");
+Object.defineProperty(exports, "shutdownChaosLatency", { enumerable: true, get: function () { return chaos_inject_latency_1.shutdown; } });
+var chaos_inject_failure_1 = require("../mcp/handlers/chaos/chaos-inject-failure");
+Object.defineProperty(exports, "shutdownChaosFailure", { enumerable: true, get: function () { return chaos_inject_failure_1.shutdown; } });
+//# sourceMappingURL=IntervalRegistry.js.map

package/dist/utils/IntervalRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IntervalRegistry.js","sourceRoot":"","sources":["../../src/utils/IntervalRegistry.ts"],"names":[],"mappings":"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"}

package/dist/utils/index.d.ts

@@ -5,6 +5,7 @@ export { Logger, LogLevel } from './Logger';
 export { Config } from './Config';
 export { Database } from './Database';
 export { TestFrameworkExecutor } from './TestFrameworkExecutor';
+export { IntervalRegistry, shutdownChaosLatency, shutdownChaosFailure, } from './IntervalRegistry';
 export type { FleetConfig, AgentConfig, DatabaseConfig } from './Config';
 export type { DatabaseRow } from './Database';
 export type { TestFrameworkConfig, TestExecutionResult, TestCaseResult, CoverageData, FileCoverage } from './TestFrameworkExecutor';

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,YAAY,EACb,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AACzE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,YAAY,EACV,mBAAmB,EACnB,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,YAAY,EACb,MAAM,yBAAyB,CAAC"}

package/dist/utils/index.js

@@ -3,7 +3,7 @@
  * Utils - Export all utility classes
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TestFrameworkExecutor = exports.Database = exports.Config = exports.LogLevel = exports.Logger = void 0;
+exports.shutdownChaosFailure = exports.shutdownChaosLatency = exports.IntervalRegistry = exports.TestFrameworkExecutor = exports.Database = exports.Config = exports.LogLevel = exports.Logger = void 0;
 var Logger_1 = require("./Logger");
 Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return Logger_1.Logger; } });
 Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return Logger_1.LogLevel; } });
@@ -13,4 +13,8 @@ var Database_1 = require("./Database");
 Object.defineProperty(exports, "Database", { enumerable: true, get: function () { return Database_1.Database; } });
 var TestFrameworkExecutor_1 = require("./TestFrameworkExecutor");
 Object.defineProperty(exports, "TestFrameworkExecutor", { enumerable: true, get: function () { return TestFrameworkExecutor_1.TestFrameworkExecutor; } });
+var IntervalRegistry_1 = require("./IntervalRegistry");
+Object.defineProperty(exports, "IntervalRegistry", { enumerable: true, get: function () { return IntervalRegistry_1.IntervalRegistry; } });
+Object.defineProperty(exports, "shutdownChaosLatency", { enumerable: true, get: function () { return IntervalRegistry_1.shutdownChaosLatency; } });
+Object.defineProperty(exports, "shutdownChaosFailure", { enumerable: true, get: function () { return IntervalRegistry_1.shutdownChaosFailure; } });
 //# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,mCAA4C;AAAnC,gGAAA,MAAM,OAAA;AAAE,kGAAA,QAAQ,OAAA;AACzB,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,mCAA4C;AAAnC,gGAAA,MAAM,OAAA;AAAE,kGAAA,QAAQ,OAAA;AACzB,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAC9B,uDAI4B;AAH1B,oHAAA,gBAAgB,OAAA;AAChB,wHAAA,oBAAoB,OAAA;AACpB,wHAAA,oBAAoB,OAAA"}

package/docs/reference/agents.md

@@ -377,6 +377,39 @@ Task("Chaos testing", "Test system resilience with controlled failures", "qe-cha
 
 ---
 
+## MCP Tool Discovery System
+
+The Agentic QE Fleet uses **lazy-loaded MCP tools** to reduce initial context by 87%.
+
+### Tool Discovery
+
+```javascript
+// Discover available tool domains
+mcp__agentic_qe__tools_discover()
+// Returns: security, coverage, test-generation, test-execution, quality-gates,
+//          fleet-management, memory, learning, patterns, reporting
+
+// Load specific domain tools
+mcp__agentic_qe__tools_load_domain({ domain: "security" })
+mcp__agentic_qe__tools_load_domain({ domain: "coverage" })
+```
+
+### Automatic Loading
+
+Tools are **auto-loaded based on keywords** when agents work:
+- "security", "vulnerability" → loads security tools
+- "coverage", "gaps" → loads coverage tools
+- "generate", "create tests" → loads test-generation tools
+- "execute", "run tests" → loads test-execution tools
+
+### Benefits
+
+- **87% context reduction** (from 15,000 to 2,000 tokens initially)
+- **Faster agent spawning** with minimal overhead
+- **On-demand loading** only when tools are needed
+
+---
+
 ## Agent Coordination
 
 All agents coordinate through the **`aqe/*` memory namespace**:

package/docs/reference/usage.md

@@ -71,6 +71,66 @@ claude mcp list
 # Should show: agentic-qe: npm run mcp:start - ✓ Connected
 ```
 
+### Tool Discovery System (New in v2.1.0)
+
+The MCP server uses **lazy loading** to reduce initial context by 87%.
+
+#### Discover Available Domains
+
+```javascript
+// List all available tool domains
+mcp__agentic_qe__tools_discover()
+
+// Returns:
+// {
+//   domains: [
+//     "security", "coverage", "test-generation", "test-execution",
+//     "quality-gates", "fleet-management", "memory", "learning",
+//     "patterns", "reporting"
+//   ]
+// }
+```
+
+#### Load Domain-Specific Tools
+
+```javascript
+// Load security tools (4 tools)
+mcp__agentic_qe__tools_load_domain({ domain: "security" })
+
+// Load coverage tools (3 tools)
+mcp__agentic_qe__tools_load_domain({ domain: "coverage" })
+
+// Load test generation tools (2 tools)
+mcp__agentic_qe__tools_load_domain({ domain: "test-generation" })
+```
+
+#### Automatic Loading
+
+Tools are **auto-loaded based on keywords** in agent instructions:
+
+```javascript
+// Keyword "security" triggers auto-load of security domain
+Task("Security scan", "Run security checks for vulnerabilities", "qe-security-scanner")
+
+// Keyword "coverage" triggers auto-load of coverage domain
+Task("Coverage analysis", "Find coverage gaps in UserService", "qe-coverage-analyzer")
+
+// Keyword "generate" triggers auto-load of test-generation domain
+Task("Generate tests", "Create unit tests for API endpoints", "qe-test-generator")
+```
+
+**Recognized Keywords:**
+- **security**: security, vulnerability, sast, dast, owasp
+- **coverage**: coverage, gaps, untested, branches
+- **test-generation**: generate, create tests, test suite
+- **test-execution**: execute, run tests, parallel
+- **quality-gates**: quality, gate, threshold, deployment
+- **fleet-management**: fleet, agents, orchestrate, swarm
+- **memory**: memory, store, retrieve, namespace
+- **learning**: learn, patterns, q-learning, improve
+- **patterns**: patterns, extract, search, templates
+- **reporting**: report, metrics, dashboard, export
+
 ### Using MCP Tools in Claude Code
 
 ```javascript

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentic-qe",
-  "version": "2.1.0",
-  "description": "Agentic Quality Engineering Fleet System - AI-driven quality management platform with 41 QE skills, learning, pattern reuse, ML-based flaky detection, Multi-Model Router (70-81% cost savings), streaming progress updates, 102 MCP tools, and native TypeScript hooks",
+  "version": "2.1.2",
+  "description": "Agentic Quality Engineering Fleet System - AI-driven quality management platform with 41 QE skills, learning, pattern reuse, ML-based flaky detection, Multi-Model Router (70-81% cost savings), streaming progress updates, 84 MCP tools with lazy loading (87% context reduction), and native TypeScript hooks",
   "main": "dist/cli/index.js",
   "types": "dist/cli/index.d.ts",
   "bin": {
@@ -30,6 +30,7 @@
     "test:e2e": "node --expose-gc --max-old-space-size=768 --no-compilation-cache node_modules/.bin/jest tests/e2e --runInBand --forceExit",
     "test:agents": "node --expose-gc --max-old-space-size=512 --no-compilation-cache node_modules/.bin/jest tests/agents --runInBand --forceExit",
     "test:mcp": "node --expose-gc --max-old-space-size=512 --no-compilation-cache node_modules/.bin/jest tests/mcp --runInBand --forceExit",
+    "test:mcp:integration": "node --expose-gc --max-old-space-size=768 --no-compilation-cache node_modules/.bin/jest tests/integration/mcp --runInBand --forceExit",
     "test:cli": "node --expose-gc --max-old-space-size=512 --no-compilation-cache node_modules/.bin/jest tests/cli --runInBand --forceExit",
     "test:agentdb": "node --expose-gc --max-old-space-size=1024 --no-compilation-cache node_modules/.bin/jest tests/agentdb --runInBand --forceExit",
     "test:benchmark": "node --expose-gc --max-old-space-size=2048 --no-compilation-cache node_modules/.bin/jest tests/benchmarks --runInBand --forceExit",
@@ -45,6 +46,7 @@
     "prepublishOnly": "npm run typecheck && npm run build",
     "mcp:start": "node dist/mcp/start.js",
     "mcp:validate": "node scripts/validate-mcp-tools.js",
+    "mcp:report": "node scripts/generate-mcp-report.js",
     "docs:api": "typedoc --out docs/api src --exclude '**/*.test.ts' --excludePrivate",
     "verify:counts": "tsx scripts/verify-counts.ts",
     "verify:agent-skills": "tsx scripts/verify-agent-skills.ts",
@@ -166,6 +168,7 @@
     "istanbul-lib-coverage": "^3.2.2",
     "jest": "^30.2.0",
     "jest-extended": "^6.0.0",
+    "jest-junit": "^16.0.0",
     "nodemon": "^3.0.2",
     "react": "^18.3.1",
     "rimraf": "^6.0.1",