agentic-qe 2.3.3 → 2.3.4

package/dist/learning/transfer/TransferProtocol.d.ts

@@ -0,0 +1,172 @@
+/**
+ * TransferProtocol - Full cross-agent pattern transfer implementation
+ *
+ * Extends TransferPrototype with stricter thresholds, validation,
+ * and registry tracking for production use.
+ *
+ * Part of the Nightly-Learner Phase 2 implementation.
+ *
+ * @version 1.0.0
+ * @module src/learning/transfer/TransferProtocol
+ */
+import { EventEmitter } from 'events';
+export interface TransferRequest {
+    id: string;
+    sourceAgent: string;
+    targetAgent: string;
+    patternIds: string[];
+    priority: 'high' | 'medium' | 'low';
+    reason: string;
+    requestedAt: Date;
+    requestedBy?: string;
+}
+export interface TransferResult {
+    requestId: string;
+    sourceAgent: string;
+    targetAgent: string;
+    patternsTransferred: number;
+    patternsSkipped: number;
+    patternsRejected: number;
+    successRate: number;
+    details: TransferDetail[];
+    duration: number;
+    validationPassed: boolean;
+}
+export interface TransferDetail {
+    patternId: string;
+    status: 'transferred' | 'skipped' | 'rejected';
+    reason?: string;
+    compatibilityScore: number;
+    validationResult?: ValidationResult;
+}
+export interface ValidationResult {
+    passed: boolean;
+    tests: ValidationTest[];
+    overallScore: number;
+}
+export interface ValidationTest {
+    name: string;
+    passed: boolean;
+    score: number;
+    message?: string;
+}
+export interface TransferProtocolConfig {
+    /** Database path. Default: .agentic-qe/memory.db */
+    dbPath?: string;
+    /** Minimum compatibility score for transfer. Default: 0.5 */
+    compatibilityThreshold?: number;
+    /** Enable post-transfer validation. Default: true */
+    enableValidation?: boolean;
+    /** Maximum patterns per transfer. Default: 50 */
+    maxPatternsPerTransfer?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export interface TransferStats {
+    totalRequests: number;
+    successfulTransfers: number;
+    failedTransfers: number;
+    overallSuccessRate: number;
+    byAgentPair: Map<string, {
+        success: number;
+        fail: number;
+    }>;
+    averageCompatibilityScore: number;
+}
+/**
+ * TransferProtocol manages cross-agent pattern transfer with validation
+ *
+ * @example
+ * ```typescript
+ * const protocol = new TransferProtocol({ compatibilityThreshold: 0.5 });
+ *
+ * const request = await protocol.createRequest({
+ *   sourceAgent: 'test-generator',
+ *   targetAgent: 'coverage-analyzer',
+ *   patternIds: ['pattern-1', 'pattern-2'],
+ *   priority: 'high',
+ *   reason: 'Share test optimization patterns',
+ * });
+ *
+ * const result = await protocol.executeTransfer(request);
+ * console.log(`Transferred ${result.patternsTransferred} patterns`);
+ * ```
+ */
+export declare class TransferProtocol extends EventEmitter {
+    private config;
+    private prototype;
+    private db;
+    private logger;
+    private agentDomains;
+    constructor(config?: TransferProtocolConfig);
+    /**
+     * Initialize database schema
+     */
+    private initializeSchema;
+    /**
+     * Initialize agent domain definitions
+     */
+    private initializeAgentDomains;
+    /**
+     * Create a transfer request
+     */
+    createRequest(params: {
+        sourceAgent: string;
+        targetAgent: string;
+        patternIds: string[];
+        priority?: 'high' | 'medium' | 'low';
+        reason: string;
+        requestedBy?: string;
+    }): Promise<TransferRequest>;
+    /**
+     * Execute a transfer request
+     */
+    executeTransfer(request: TransferRequest): Promise<TransferResult>;
+    /**
+     * Get a pattern from the database
+     */
+    private getPattern;
+    /**
+     * Calculate compatibility between pattern and target agent
+     */
+    private calculateCompatibility;
+    /**
+     * Calculate overlap with semantic similarity
+     */
+    private calculateOverlapWithSemantic;
+    /**
+     * Calculate semantic similarity between sets
+     * Uses expanded concept groups to capture related capabilities
+     */
+    private semanticSimilarity;
+    /**
+     * Perform the actual pattern transfer
+     */
+    private performTransfer;
+    /**
+     * Validate a transferred pattern
+     */
+    private validateTransfer;
+    /**
+     * Register a successful transfer
+     */
+    private registerTransfer;
+    /**
+     * Get transfer statistics
+     */
+    getStats(): TransferStats;
+    /**
+     * Get pending transfer requests
+     */
+    getPendingRequests(): TransferRequest[];
+    /**
+     * Broadcast a pattern to all compatible agents
+     */
+    broadcastPattern(patternId: string, sourceAgent: string): Promise<TransferResult[]>;
+    /**
+     * Close database connection
+     */
+    close(): void;
+}
+export default TransferProtocol;
+//# sourceMappingURL=TransferProtocol.d.ts.map

package/dist/learning/transfer/TransferProtocol.d.ts.map

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