agentic-qe 2.6.0 → 2.6.2

package/dist/plugins/BasePlugin.js

@@ -0,0 +1,154 @@
+"use strict";
+/**
+ * Base Plugin Class
+ * Phase 3 B2: Extensible Test Framework Adapters
+ *
+ * Provides a base implementation for plugins with common functionality.
+ * Extend this class to create custom plugins more easily.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BasePlugin = void 0;
+exports.createPluginMetadata = createPluginMetadata;
+/**
+ * Base plugin implementation with common functionality
+ */
+class BasePlugin {
+    constructor() {
+        this._healthy = true;
+    }
+    /**
+     * Called when plugin is loaded
+     */
+    onLoad(context) {
+        this.context = context;
+        this.log('debug', 'Plugin loaded');
+    }
+    /**
+     * Called when plugin is activated
+     * Override in subclass for custom activation logic
+     */
+    async onActivate(context) {
+        this.context = context;
+        this.log('info', 'Plugin activated');
+    }
+    /**
+     * Called when plugin is deactivated
+     * Override in subclass for custom deactivation logic
+     */
+    async onDeactivate(_context) {
+        this.log('info', 'Plugin deactivated');
+    }
+    /**
+     * Called when plugin is unloaded
+     */
+    onUnload(_context) {
+        this.context = undefined;
+        this.log('debug', 'Plugin unloaded');
+    }
+    /**
+     * Called when configuration changes
+     */
+    onConfigChange(_context, changes) {
+        this.log('debug', 'Config changed', changes);
+    }
+    /**
+     * Health check - returns true if plugin is healthy
+     */
+    async healthCheck() {
+        return this._healthy;
+    }
+    /**
+     * Mark plugin as unhealthy
+     */
+    setUnhealthy() {
+        this._healthy = false;
+    }
+    /**
+     * Mark plugin as healthy
+     */
+    setHealthy() {
+        this._healthy = true;
+    }
+    /**
+     * Log a message using the plugin's logger
+     */
+    log(level, message, ...args) {
+        if (this.context?.logger) {
+            this.context.logger[level](message, ...args);
+        }
+        else {
+            console[level](`[${this.metadata.id}] ${message}`, ...args);
+        }
+    }
+    /**
+     * Get configuration value
+     */
+    getConfig(key, defaultValue) {
+        return this.context?.config.get(key, defaultValue);
+    }
+    /**
+     * Set configuration value
+     */
+    setConfig(key, value) {
+        this.context?.config.set(key, value);
+    }
+    /**
+     * Emit an event
+     */
+    emit(event, data) {
+        this.context?.events.emit(event, data);
+    }
+    /**
+     * Listen for an event
+     */
+    on(event, handler) {
+        return this.context?.events.on(event, handler) ?? (() => { });
+    }
+    /**
+     * Get persistent storage value
+     */
+    async getStoredValue(key) {
+        return this.context?.storage.get(key);
+    }
+    /**
+     * Set persistent storage value
+     */
+    async setStoredValue(key, value) {
+        await this.context?.storage.set(key, value);
+    }
+    /**
+     * Get another plugin
+     */
+    getPlugin(id) {
+        return this.context?.pluginManager.getPlugin(id);
+    }
+    /**
+     * Register a service for other plugins to use
+     */
+    registerService(name, service) {
+        this.context?.pluginManager.registerService(name, service);
+    }
+    /**
+     * Get a registered service
+     */
+    getService(name) {
+        return this.context?.pluginManager.getService(name);
+    }
+}
+exports.BasePlugin = BasePlugin;
+/**
+ * Helper to create plugin metadata
+ */
+function createPluginMetadata(options) {
+    return {
+        id: options.id,
+        name: options.name,
+        version: options.version,
+        description: options.description,
+        author: options.author,
+        category: options.category,
+        minAgenticQEVersion: options.minAgenticQEVersion || '2.0.0',
+        dependencies: options.dependencies,
+    };
+}
+//# sourceMappingURL=BasePlugin.js.map

package/dist/plugins/BasePlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasePlugin.js","sourceRoot":"","sources":["../../src/plugins/BasePlugin.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAgKH,oDAsBC;AA7KD;;GAEG;AACH,MAAsB,UAAU;IAAhC;QAEU,aAAQ,GAAG,IAAI,CAAC;IA6I1B,CAAC;IAtIC;;OAEG;IACH,MAAM,CAAC,OAAsB;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,OAAsB;QACrC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,QAAuB;QACxC,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,QAAuB;QAC9B,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,iBAAiB,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,QAAuB,EAAE,OAAgC;QACtE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,WAAW;QACf,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACO,YAAY;QACpB,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;IACxB,CAAC;IAED;;OAEG;IACO,UAAU;QAClB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;IACvB,CAAC;IAED;;OAEG;IACO,GAAG,CAAC,KAA0C,EAAE,OAAe,EAAE,GAAG,IAAe;QAC3F,IAAI,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,EAAE,KAAK,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;IAED;;OAEG;IACO,SAAS,CAAI,GAAW,EAAE,YAAgB;QAClD,OAAO,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IACrD,CAAC;IAED;;OAEG;IACO,SAAS,CAAI,GAAW,EAAE,KAAQ;QAC1C,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACO,IAAI,CAAC,KAAa,EAAE,IAAc;QAC1C,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACO,EAAE,CAAC,KAAa,EAAE,OAAgC;QAC1D,OAAO,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,cAAc,CAAI,GAAW;QAC3C,OAAO,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACO,KAAK,CAAC,cAAc,CAAI,GAAW,EAAE,KAAQ;QACrD,MAAM,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACO,SAAS,CAAmB,EAAU;QAC9C,OAAO,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,SAAS,CAAI,EAAE,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACO,eAAe,CAAI,IAAY,EAAE,OAAU;QACnD,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,eAAe,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED;;OAEG;IACO,UAAU,CAAI,IAAY;QAClC,OAAO,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,UAAU,CAAI,IAAI,CAAC,CAAC;IACzD,CAAC;CACF;AA/ID,gCA+IC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAClC,OASC;IAED,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,mBAAmB,EAAE,OAAO,CAAC,mBAAmB,IAAI,OAAO;QAC3D,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAC;AACJ,CAAC"}

package/dist/plugins/PluginManager.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Plugin Manager Implementation
+ * Phase 3 B2: Extensible Test Framework Adapters
+ *
+ * Handles plugin lifecycle:
+ * - Discovery and registration
+ * - Loading with lazy/eager strategies
+ * - Activation and deactivation
+ * - Hot-reload for development
+ * - Dependency resolution
+ * - Error isolation
+ */
+import { EventEmitter } from 'events';
+import { Plugin, PluginState, PluginCategory, PluginManagerConfig, PluginDiscoveryResult } from './types';
+/**
+ * Plugin Manager - Central hub for plugin lifecycle management
+ */
+export declare class PluginManager extends EventEmitter {
+    private readonly config;
+    private readonly plugins;
+    private readonly services;
+    private readonly pluginStorage;
+    private initialized;
+    private fileWatchers;
+    private pluginPathMap;
+    constructor(config?: Partial<PluginManagerConfig>);
+    /**
+     * Initialize the plugin manager
+     */
+    initialize(): Promise<void>;
+    /**
+     * Discover plugins in configured directories
+     * This method actually loads plugins from disk using dynamic import
+     */
+    discoverPlugins(): Promise<PluginDiscoveryResult>;
+    /**
+     * Register a plugin programmatically
+     */
+    registerPlugin(plugin: Plugin): Promise<void>;
+    /**
+     * Load a plugin by ID
+     */
+    loadPlugin(pluginId: string): Promise<void>;
+    /**
+     * Activate a plugin
+     */
+    activatePlugin(pluginId: string): Promise<void>;
+    /**
+     * Deactivate a plugin
+     */
+    deactivatePlugin(pluginId: string): Promise<void>;
+    /**
+     * Unload a plugin
+     */
+    unloadPlugin(pluginId: string): Promise<void>;
+    /**
+     * Activate all loaded plugins
+     */
+    activateAll(): Promise<void>;
+    /**
+     * Deactivate all plugins
+     */
+    deactivateAll(): Promise<void>;
+    /**
+     * Get a plugin by ID
+     */
+    getPlugin<T extends Plugin = Plugin>(pluginId: string): T | undefined;
+    /**
+     * Check if plugin exists
+     */
+    hasPlugin(pluginId: string): boolean;
+    /**
+     * Get plugins by category
+     */
+    getPluginsByCategory(category: PluginCategory): Plugin[];
+    /**
+     * Get all active plugins
+     */
+    getActivePlugins(): Plugin[];
+    /**
+     * Get all registered plugins
+     */
+    getAllPlugins(): Plugin[];
+    /**
+     * Check if plugin manager is initialized
+     */
+    isInitialized(): boolean;
+    /**
+     * Get plugin state
+     */
+    getPluginState(pluginId: string): PluginState | undefined;
+    /**
+     * Register a service
+     */
+    registerService<T>(name: string, service: T): void;
+    /**
+     * Get a service
+     */
+    getService<T>(name: string): T | undefined;
+    /**
+     * Shutdown the plugin manager
+     */
+    shutdown(): Promise<void>;
+    private extractMetadata;
+    private isCompatible;
+    private resolveDependencies;
+    private createPluginContext;
+    private createPluginManagerAPI;
+    private createPluginLogger;
+    private createPluginConfigStore;
+    private createPluginEventBus;
+    private createPluginStorage;
+    private setupHotReload;
+    /**
+     * Reload a plugin (deactivate, unload, rediscover, load, reactivate)
+     */
+    reloadPlugin(pluginId: string): Promise<void>;
+    /**
+     * Get plugin ID from a file path within plugin directories
+     */
+    private getPluginIdFromPath;
+    /**
+     * Get the filesystem path for a plugin
+     */
+    private getPluginPath;
+    /**
+     * Load a plugin from a filesystem path
+     */
+    private loadPluginFromPath;
+    /**
+     * Clear require cache for a module and its dependencies
+     */
+    private clearRequireCache;
+    private withTimeout;
+    private log;
+}
+/**
+ * Get or create the global plugin manager instance
+ */
+export declare function getPluginManager(config?: Partial<PluginManagerConfig>): PluginManager;
+/**
+ * Reset the global plugin manager (for testing)
+ */
+export declare function resetPluginManager(): Promise<void>;
+//# sourceMappingURL=PluginManager.d.ts.map

package/dist/plugins/PluginManager.d.ts.map

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