agentic-qe 2.6.0 → 2.6.1

package/CHANGELOG.md

@@ -7,6 +7,91 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [2.6.1] - 2025-12-23
+
+### Added
+
+#### Phase 3 B2: Extensible Plugin System
+
+A comprehensive plugin architecture enabling hot-swappable test framework adapters and community extensibility.
+
+**Core Components (4,152 lines)**
+- **Plugin Types** (`src/plugins/types.ts`) - 612 lines of comprehensive TypeScript interfaces
+  - `Plugin`, `TestFrameworkPlugin`, `PluginMetadata` interfaces
+  - `PluginState` enum (DISCOVERED, LOADING, LOADED, ACTIVATING, ACTIVE, DEACTIVATING, INACTIVE, ERROR)
+  - `PluginCategory` enum (TEST_FRAMEWORK, MCP_TOOLS, REPORTING, UTILITY, INTEGRATION)
+  - Full lifecycle hook definitions (onLoad, onActivate, onDeactivate, onUnload)
+
+- **Plugin Manager** (`src/plugins/PluginManager.ts`) - 987 lines
+  - Plugin discovery from configured directories
+  - Lazy/eager loading strategies with `autoActivate` config
+  - **Real hot-reload** via `fs.watch` with 300ms debouncing
+  - **Real plugin loading** via dynamic `import()` from disk
+  - Semver-based dependency resolution
+  - Service registration and cross-plugin communication
+  - Event-driven architecture with full lifecycle events
+
+- **Base Plugin** (`src/plugins/BasePlugin.ts`) - 189 lines
+  - Foundation class for plugin development
+  - Built-in logging, service registration, event handling
+  - Storage abstraction for plugin state
+
+**Reference Implementations**
+- **PlaywrightPlugin** (`src/plugins/adapters/PlaywrightPlugin.ts`) - 539 lines
+  - E2E test generation with proper imports and structure
+  - Test file parsing (describe blocks, tests, hooks)
+  - **Real test execution** via `child_process.spawn`
+  - Playwright JSON output parsing
+
+- **VitestPlugin** (`src/plugins/adapters/VitestPlugin.ts`) - 709 lines
+  - Unit test generation for TypeScript/JavaScript
+  - Test file parsing with nested describe support
+  - **Real test execution** via `child_process.spawn`
+  - **Real coverage parsing** from Vitest JSON output
+
+- **McpToolsPlugin** (`src/plugins/adapters/McpToolsPlugin.ts`) - 637 lines
+  - **Real MCP server connection** via JSON-RPC over HTTP
+  - Dynamic capability discovery from server (`tools/list`)
+  - Tool invocation with proper request/response handling
+  - Graceful fallback to static capabilities when server unavailable
+  - Configurable endpoint, timeout, and API key authentication
+
+**Test Suite**
+- **PluginManager.test.ts** (`tests/unit/plugins/`) - 395 lines, 30 tests
+  - Plugin registration, activation, deactivation
+  - Category filtering, service registration
+  - Lifecycle hook verification
+  - All tests passing
+
+#### Phase 3 D1: Memory Pooling (Already Committed)
+
+Pre-allocated agent pooling for dramatic spawn performance improvements.
+
+**Performance Achieved**
+- **1750x speedup**: 0.057ms pooled vs 100ms fresh spawn
+- Target was 16x (<6ms) - **exceeded by 109x**
+
+**Core Components**
+- **AgentPool** (`src/agents/pool/AgentPool.ts`) - 744 lines
+  - Generic pool with configurable min/max/warmup sizes
+  - Health checks and automatic expansion
+  - Priority queue for concurrent acquisitions
+
+- **QEAgentPoolFactory** (`src/agents/pool/QEAgentPoolFactory.ts`) - 289 lines
+  - QE-specific pool configurations per agent type
+  - Factory pattern for pool management
+
+### Fixed
+
+- **Tree-sitter peer dependency** warnings on `npm install`
+- **Fraudulent benchmarks** in D1 implementation replaced with honest measurements
+
+### Changed
+
+- Enhanced `src/mcp/handlers/agent-spawn.ts` with pool integration
+- Enhanced `src/mcp/handlers/fleet-init.ts` with pool integration
+- Updated parser benchmark reports
+
 ## [2.6.0] - 2025-12-22
 
 ### Added

package/README.md

@@ -11,7 +11,7 @@
 [![Run in Smithery](https://smithery.ai/badge/skills/proffesor-for-testing)](https://smithery.ai/skills?ns=proffesor-for-testing&utm_source=github&utm_medium=badge)
 
 
-**Version 2.6.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.6.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)
 
 > AI-powered test automation that learns from every task, switches between 300+ AI models on-the-fly, scores code testability, visualizes agent activity in real-time, and improves autonomously overnight — with built-in safety guardrails and full observability.
 

package/dist/agents/pool/AgentPool.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Agent Pool Implementation
+ * Phase 3 D1: Memory Pooling for 16x Agent Spawn Speedup
+ *
+ * Target Performance:
+ * - Spawn time: <6ms (down from ~50-100ms)
+ * - Memory stable under load
+ * - Graceful degradation when exhausted
+ *
+ * Architecture:
+ * - Pre-allocated agent instances per type
+ * - Thread-safe acquire/release with mutex
+ * - Automatic pool expansion on demand
+ * - Health monitoring and recovery
+ */
+import { EventEmitter } from 'events';
+import { QEAgentType } from '../../types';
+import { AgentPoolConfig, PoolStats, AcquireOptions, ReleaseOptions, AcquireResult, IResettableAgent } from './types';
+/**
+ * Agent Pool - Pre-allocated agent instance management
+ *
+ * @example
+ * ```typescript
+ * const pool = new AgentPool(factory, config);
+ * await pool.warmup();
+ *
+ * // Fast acquisition (<6ms)
+ * const { agent, meta } = await pool.acquire('test-generator');
+ *
+ * // Use agent...
+ * await agent.executeTask(task);
+ *
+ * // Return to pool
+ * await pool.release(meta.poolId);
+ * ```
+ */
+export declare class AgentPool<T extends IResettableAgent> extends EventEmitter {
+    private readonly config;
+    private readonly factory;
+    private readonly pools;
+    private readonly agentsByPoolId;
+    private readonly waitingQueues;
+    private readonly mutexes;
+    private stats;
+    private healthCheckTimer;
+    private isShuttingDown;
+    constructor(factory: AgentFactory<T>, config?: Partial<AgentPoolConfig>);
+    /**
+     * Warm up the pool by pre-creating agents
+     * Should be called during application startup
+     */
+    warmup(types?: QEAgentType[]): Promise<void>;
+    /**
+     * Acquire an agent from the pool
+     * Returns immediately if available, otherwise waits or creates new
+     *
+     * @param type - Agent type to acquire
+     * @param options - Acquisition options
+     * @returns Acquired agent with metadata
+     */
+    acquire(type: QEAgentType, options?: AcquireOptions): Promise<AcquireResult<T>>;
+    /**
+     * Release an agent back to the pool
+     *
+     * @param poolId - Pool ID of the agent to release
+     * @param options - Release options
+     */
+    release(poolId: string, options?: ReleaseOptions): Promise<void>;
+    /**
+     * Get current pool statistics
+     */
+    getStats(): PoolStats;
+    /**
+     * Shutdown the pool and dispose all agents
+     */
+    shutdown(): Promise<void>;
+    private getPool;
+    private getTypeConfig;
+    private getConfiguredTypes;
+    private createPooledAgent;
+    private addToPool;
+    private tryAcquireFromPool;
+    private canCreateMore;
+    private getWaitingCount;
+    private waitForAgent;
+    private removeWaitingRequest;
+    private fulfillWaitingRequest;
+    private disposeAgent;
+    private replenishPool;
+    private recordAcquisition;
+    private startHealthCheck;
+    private performHealthCheck;
+    private log;
+}
+/**
+ * Factory interface for creating agents
+ */
+export interface AgentFactory<T extends IResettableAgent> {
+    /**
+     * Create a new agent instance
+     */
+    create(type: QEAgentType): Promise<T>;
+    /**
+     * Initialize an agent (heavy async operations)
+     */
+    initialize(agent: T): Promise<void>;
+    /**
+     * Dispose an agent (cleanup resources)
+     */
+    dispose(agent: T): Promise<void>;
+}
+//# sourceMappingURL=AgentPool.d.ts.map

package/dist/agents/pool/AgentPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPool.d.ts","sourceRoot":"","sources":["../../../src/agents/pool/AgentPool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EACL,eAAe,EAIf,SAAS,EAET,cAAc,EACd,cAAc,EACd,aAAa,EAEb,gBAAgB,EACjB,MAAM,SAAS,CAAC;AA2CjB;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,SAAS,CAAC,CAAC,SAAS,gBAAgB,CAAE,SAAQ,YAAY;IACrE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkB;IAG1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAsD;IAG5E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA+C;IAG9E,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoD;IAGlF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA8C;IAGtE,OAAO,CAAC,KAAK,CAIX;IAGF,OAAO,CAAC,gBAAgB,CAA+B;IAGvD,OAAO,CAAC,cAAc,CAAS;gBAG7B,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EACxB,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAavC;;;OAGG;IACG,MAAM,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoClD;;;;;;;OAOG;IACG,OAAO,CACX,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAgF5B;;;;;OAKG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmD1E;;OAEG;IACH,QAAQ,IAAI,SAAS;IA8DrB;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAoC/B,OAAO,CAAC,OAAO;IASf,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,kBAAkB;YAeZ,iBAAiB;IAqC/B,OAAO,CAAC,SAAS;YAMH,kBAAkB;IA0ChC,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,eAAe;YAKT,YAAY;IA6C1B,OAAO,CAAC,oBAAoB;YAUd,qBAAqB;YAkBrB,YAAY;YAkCZ,aAAa;IAmB3B,OAAO,CAAC,iBAAiB;IAQzB,OAAO,CAAC,gBAAgB;YAMV,kBAAkB;IAsBhC,OAAO,CAAC,GAAG;CAKZ;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,gBAAgB;IACtD;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAEtC;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpC;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC"}