agentic-qe 2.3.4 → 2.4.0

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

@@ -0,0 +1,245 @@
+/**
+ * TransferRegistry - Track pattern transfers between agents
+ *
+ * Records all transfer attempts (success and failure), queries transfer history,
+ * and calculates success rates per agent pair.
+ *
+ * Part of the Nightly-Learner Phase 2 implementation.
+ *
+ * @version 1.0.0
+ * @module src/learning/transfer/TransferRegistry
+ */
+import type { TransferResult } from './TransferProtocol';
+/**
+ * Transfer record stored in the registry
+ */
+export interface TransferRecord {
+    /** Unique transfer record ID */
+    id: string;
+    /** Source agent identifier */
+    sourceAgent: string;
+    /** Target agent identifier */
+    targetAgent: string;
+    /** Pattern ID that was transferred */
+    patternId: string;
+    /** Transfer status */
+    status: 'success' | 'failed' | 'skipped';
+    /** Reason for failure or skip */
+    reason?: string;
+    /** Compatibility score calculated during transfer */
+    compatibilityScore?: number;
+    /** Timestamp when transfer was recorded */
+    timestamp: Date;
+}
+/**
+ * Registry configuration options
+ */
+export interface TransferRegistryConfig {
+    /** Database path. Default: .agentic-qe/memory.db */
+    dbPath?: string;
+}
+/**
+ * Overall transfer statistics
+ */
+export interface TransferOverallStats {
+    /** Total number of transfer attempts */
+    totalTransfers: number;
+    /** Overall success rate (0-1) */
+    successRate: number;
+    /** Statistics by agent pair */
+    byAgentPair: Map<string, {
+        success: number;
+        fail: number;
+    }>;
+}
+/**
+ * TransferRegistry tracks all pattern transfer attempts
+ *
+ * Records success/failure of transfers, provides historical queries,
+ * and calculates success metrics per agent pair.
+ *
+ * @example
+ * ```typescript
+ * const registry = new TransferRegistry({ dbPath: './memory.db' });
+ *
+ * // Record a transfer result
+ * await registry.record(transferResult);
+ *
+ * // Query transfer history
+ * const history = registry.getTransferHistory('test-generator', 10);
+ *
+ * // Get success rate between two agents
+ * const rate = registry.getSuccessRate('test-generator', 'coverage-analyzer');
+ *
+ * // Get overall statistics
+ * const stats = registry.getOverallStats();
+ * console.log(`Success rate: ${(stats.successRate * 100).toFixed(1)}%`);
+ *
+ * registry.close();
+ * ```
+ */
+export declare class TransferRegistry {
+    private db;
+    private logger;
+    private config;
+    constructor(config?: TransferRegistryConfig);
+    /**
+     * Initialize database schema for transfer registry
+     */
+    private initializeSchema;
+    /**
+     * Record a transfer result
+     *
+     * Extracts individual transfer details from TransferResult and stores each
+     * pattern transfer as a separate record.
+     *
+     * @param result - Transfer result from TransferProtocol
+     * @returns Promise that resolves when all records are stored
+     *
+     * @example
+     * ```typescript
+     * const result = await protocol.executeTransfer(request);
+     * await registry.record(result);
+     * ```
+     */
+    record(result: TransferResult): Promise<void>;
+    /**
+     * Get transfer history for a specific agent
+     *
+     * Returns records where the agent was either source or target.
+     *
+     * @param agentId - Agent identifier
+     * @param limit - Maximum number of records to return (default: 50)
+     * @returns Array of transfer records, sorted by timestamp (newest first)
+     *
+     * @example
+     * ```typescript
+     * const recent = registry.getTransferHistory('test-generator', 20);
+     * console.log(`Found ${recent.length} recent transfers`);
+     * ```
+     */
+    getTransferHistory(agentId: string, limit?: number): TransferRecord[];
+    /**
+     * Get success rate between two specific agents
+     *
+     * Calculates the ratio of successful transfers to total attempts.
+     *
+     * @param sourceAgent - Source agent identifier
+     * @param targetAgent - Target agent identifier
+     * @returns Success rate as a decimal (0-1), or 0 if no transfers exist
+     *
+     * @example
+     * ```typescript
+     * const rate = registry.getSuccessRate('test-generator', 'coverage-analyzer');
+     * console.log(`Success rate: ${(rate * 100).toFixed(1)}%`);
+     * ```
+     */
+    getSuccessRate(sourceAgent: string, targetAgent: string): number;
+    /**
+     * Get overall transfer statistics
+     *
+     * Aggregates all transfer records to provide:
+     * - Total transfer count
+     * - Overall success rate
+     * - Per-agent-pair success/failure counts
+     *
+     * @returns Overall statistics object
+     *
+     * @example
+     * ```typescript
+     * const stats = registry.getOverallStats();
+     * console.log(`Total transfers: ${stats.totalTransfers}`);
+     * console.log(`Success rate: ${(stats.successRate * 100).toFixed(1)}%`);
+     *
+     * for (const [pair, counts] of stats.byAgentPair) {
+     *   console.log(`${pair}: ${counts.success} success, ${counts.fail} fail`);
+     * }
+     * ```
+     */
+    getOverallStats(): TransferOverallStats;
+    /**
+     * Get recent transfers within a time window
+     *
+     * @param hours - Number of hours to look back (default: 24)
+     * @returns Array of transfer records within the time window
+     *
+     * @example
+     * ```typescript
+     * // Get transfers from last 12 hours
+     * const recent = registry.getRecentTransfers(12);
+     * console.log(`${recent.length} transfers in last 12 hours`);
+     * ```
+     */
+    getRecentTransfers(hours?: number): TransferRecord[];
+    /**
+     * Get transfer statistics for a specific pattern
+     *
+     * Useful for tracking how well a specific pattern transfers across agents.
+     *
+     * @param patternId - Pattern identifier
+     * @returns Statistics for the pattern's transfer history
+     *
+     * @example
+     * ```typescript
+     * const stats = registry.getPatternStats('pattern-123');
+     * console.log(`Pattern transferred ${stats.total} times with ${stats.successRate * 100}% success`);
+     * ```
+     */
+    getPatternStats(patternId: string): {
+        total: number;
+        successRate: number;
+        agents: string[];
+    };
+    /**
+     * Get most successful transfer pairs
+     *
+     * Identifies agent pairs with the highest transfer success rates.
+     *
+     * @param limit - Maximum number of pairs to return (default: 10)
+     * @param minTransfers - Minimum number of transfers required (default: 5)
+     * @returns Array of agent pairs sorted by success rate
+     *
+     * @example
+     * ```typescript
+     * const topPairs = registry.getTopTransferPairs(5, 10);
+     * topPairs.forEach(pair => {
+     *   console.log(`${pair.sourceAgent} -> ${pair.targetAgent}: ${(pair.successRate * 100).toFixed(1)}%`);
+     * });
+     * ```
+     */
+    getTopTransferPairs(limit?: number, minTransfers?: number): Array<{
+        sourceAgent: string;
+        targetAgent: string;
+        successRate: number;
+        totalTransfers: number;
+    }>;
+    /**
+     * Clear old transfer records
+     *
+     * Removes records older than the specified number of days.
+     * Useful for maintaining database size.
+     *
+     * @param daysToKeep - Number of days of history to retain (default: 90)
+     * @returns Number of records deleted
+     *
+     * @example
+     * ```typescript
+     * const deleted = registry.clearOldRecords(30);
+     * console.log(`Deleted ${deleted} records older than 30 days`);
+     * ```
+     */
+    clearOldRecords(daysToKeep?: number): number;
+    /**
+     * Close database connection
+     *
+     * Should be called when registry is no longer needed to release resources.
+     *
+     * @example
+     * ```typescript
+     * registry.close();
+     * ```
+     */
+    close(): void;
+}
+export default TransferRegistry;
+//# sourceMappingURL=TransferRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"TransferRegistry.d.ts","sourceRoot":"","sources":["../../../src/learning/transfer/TransferRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,gCAAgC;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB;IACtB,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IACzC,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAAyB;IACnC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAmC;gBAErC,MAAM,CAAC,EAAE,sBAAsB;IAW3C;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;;;;;;;;;;;;;OAcG;IACG,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAsCnD;;;;;;;;;;;;;;OAcG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAW,GAAG,cAAc,EAAE;IA6BzE;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;IAgBhE;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,eAAe,IAAI,oBAAoB;IA0CvC;;;;;;;;;;;;OAYG;IACH,kBAAkB,CAAC,KAAK,GAAE,MAAW,GAAG,cAAc,EAAE;IA8BxD;;;;;;;;;;;;;OAaG;IACH,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE;IAqB5F;;;;;;;;;;;;;;;;OAgBG;IACH,mBAAmB,CAAC,KAAK,GAAE,MAAW,EAAE,YAAY,GAAE,MAAU,GAAG,KAAK,CAAC;QACvE,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IA2BF;;;;;;;;;;;;;;OAcG;IACH,eAAe,CAAC,UAAU,GAAE,MAAW,GAAG,MAAM;IAgBhD;;;;;;;;;OASG;IACH,KAAK,IAAI,IAAI;CAId;AAED,eAAe,gBAAgB,CAAC"}

package/dist/learning/transfer/TransferRegistry.js

@@ -0,0 +1,410 @@
+"use strict";
+/**
+ * TransferRegistry - Track pattern transfers between agents
+ *
+ * Records all transfer attempts (success and failure), queries transfer history,
+ * and calculates success rates per agent pair.
+ *
+ * Part of the Nightly-Learner Phase 2 implementation.
+ *
+ * @version 1.0.0
+ * @module src/learning/transfer/TransferRegistry
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransferRegistry = void 0;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const path = __importStar(require("path"));
+const Logger_1 = require("../../utils/Logger");
+const SecureRandom_1 = require("../../utils/SecureRandom");
+/**
+ * TransferRegistry tracks all pattern transfer attempts
+ *
+ * Records success/failure of transfers, provides historical queries,
+ * and calculates success metrics per agent pair.
+ *
+ * @example
+ * ```typescript
+ * const registry = new TransferRegistry({ dbPath: './memory.db' });
+ *
+ * // Record a transfer result
+ * await registry.record(transferResult);
+ *
+ * // Query transfer history
+ * const history = registry.getTransferHistory('test-generator', 10);
+ *
+ * // Get success rate between two agents
+ * const rate = registry.getSuccessRate('test-generator', 'coverage-analyzer');
+ *
+ * // Get overall statistics
+ * const stats = registry.getOverallStats();
+ * console.log(`Success rate: ${(stats.successRate * 100).toFixed(1)}%`);
+ *
+ * registry.close();
+ * ```
+ */
+class TransferRegistry {
+    constructor(config) {
+        this.logger = Logger_1.Logger.getInstance();
+        this.config = {
+            dbPath: config?.dbPath || path.join(process.cwd(), '.agentic-qe', 'memory.db'),
+        };
+        this.db = new better_sqlite3_1.default(this.config.dbPath);
+        this.initializeSchema();
+    }
+    /**
+     * Initialize database schema for transfer registry
+     */
+    initializeSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS transfer_registry (
+        id TEXT PRIMARY KEY,
+        source_agent TEXT NOT NULL,
+        target_agent TEXT NOT NULL,
+        pattern_id TEXT NOT NULL,
+        status TEXT NOT NULL CHECK(status IN ('success', 'failed', 'skipped')),
+        reason TEXT,
+        compatibility_score REAL,
+        timestamp INTEGER NOT NULL
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_transfer_reg_source ON transfer_registry(source_agent);
+      CREATE INDEX IF NOT EXISTS idx_transfer_reg_target ON transfer_registry(target_agent);
+      CREATE INDEX IF NOT EXISTS idx_transfer_reg_pattern ON transfer_registry(pattern_id);
+      CREATE INDEX IF NOT EXISTS idx_transfer_reg_timestamp ON transfer_registry(timestamp);
+      CREATE INDEX IF NOT EXISTS idx_transfer_reg_status ON transfer_registry(status);
+      CREATE INDEX IF NOT EXISTS idx_transfer_reg_pair ON transfer_registry(source_agent, target_agent);
+    `);
+        this.logger.debug('[TransferRegistry] Schema initialized');
+    }
+    /**
+     * Record a transfer result
+     *
+     * Extracts individual transfer details from TransferResult and stores each
+     * pattern transfer as a separate record.
+     *
+     * @param result - Transfer result from TransferProtocol
+     * @returns Promise that resolves when all records are stored
+     *
+     * @example
+     * ```typescript
+     * const result = await protocol.executeTransfer(request);
+     * await registry.record(result);
+     * ```
+     */
+    async record(result) {
+        const stmt = this.db.prepare(`
+      INSERT INTO transfer_registry
+      (id, source_agent, target_agent, pattern_id, status, reason, compatibility_score, timestamp)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `);
+        const now = Date.now();
+        // Record each pattern transfer from the result
+        for (const detail of result.details) {
+            const id = `reg-${now}-${SecureRandom_1.SecureRandom.randomString(8, 'alphanumeric')}`;
+            // Map TransferDetail status to TransferRecord status
+            const status = detail.status === 'transferred' ? 'success' :
+                detail.status === 'skipped' ? 'skipped' : 'failed';
+            stmt.run(id, result.sourceAgent, result.targetAgent, detail.patternId, status, detail.reason || null, detail.compatibilityScore || null, now);
+        }
+        this.logger.debug('[TransferRegistry] Recorded transfer', {
+            requestId: result.requestId,
+            source: result.sourceAgent,
+            target: result.targetAgent,
+            records: result.details.length,
+        });
+    }
+    /**
+     * Get transfer history for a specific agent
+     *
+     * Returns records where the agent was either source or target.
+     *
+     * @param agentId - Agent identifier
+     * @param limit - Maximum number of records to return (default: 50)
+     * @returns Array of transfer records, sorted by timestamp (newest first)
+     *
+     * @example
+     * ```typescript
+     * const recent = registry.getTransferHistory('test-generator', 20);
+     * console.log(`Found ${recent.length} recent transfers`);
+     * ```
+     */
+    getTransferHistory(agentId, limit = 50) {
+        const rows = this.db.prepare(`
+      SELECT * FROM transfer_registry
+      WHERE source_agent = ? OR target_agent = ?
+      ORDER BY timestamp DESC
+      LIMIT ?
+    `).all(agentId, agentId, limit);
+        return rows.map(row => ({
+            id: row.id,
+            sourceAgent: row.source_agent,
+            targetAgent: row.target_agent,
+            patternId: row.pattern_id,
+            status: row.status,
+            reason: row.reason || undefined,
+            compatibilityScore: row.compatibility_score || undefined,
+            timestamp: new Date(row.timestamp),
+        }));
+    }
+    /**
+     * Get success rate between two specific agents
+     *
+     * Calculates the ratio of successful transfers to total attempts.
+     *
+     * @param sourceAgent - Source agent identifier
+     * @param targetAgent - Target agent identifier
+     * @returns Success rate as a decimal (0-1), or 0 if no transfers exist
+     *
+     * @example
+     * ```typescript
+     * const rate = registry.getSuccessRate('test-generator', 'coverage-analyzer');
+     * console.log(`Success rate: ${(rate * 100).toFixed(1)}%`);
+     * ```
+     */
+    getSuccessRate(sourceAgent, targetAgent) {
+        const stats = this.db.prepare(`
+      SELECT
+        COUNT(*) as total,
+        SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END) as successes
+      FROM transfer_registry
+      WHERE source_agent = ? AND target_agent = ?
+    `).get(sourceAgent, targetAgent);
+        if (!stats || stats.total === 0) {
+            return 0;
+        }
+        return stats.successes / stats.total;
+    }
+    /**
+     * Get overall transfer statistics
+     *
+     * Aggregates all transfer records to provide:
+     * - Total transfer count
+     * - Overall success rate
+     * - Per-agent-pair success/failure counts
+     *
+     * @returns Overall statistics object
+     *
+     * @example
+     * ```typescript
+     * const stats = registry.getOverallStats();
+     * console.log(`Total transfers: ${stats.totalTransfers}`);
+     * console.log(`Success rate: ${(stats.successRate * 100).toFixed(1)}%`);
+     *
+     * for (const [pair, counts] of stats.byAgentPair) {
+     *   console.log(`${pair}: ${counts.success} success, ${counts.fail} fail`);
+     * }
+     * ```
+     */
+    getOverallStats() {
+        // Get overall counts
+        const overall = this.db.prepare(`
+      SELECT
+        COUNT(*) as total,
+        SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END) as successes
+      FROM transfer_registry
+    `).get();
+        // Get per-agent-pair counts
+        const pairRows = this.db.prepare(`
+      SELECT
+        source_agent,
+        target_agent,
+        SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END) as success,
+        SUM(CASE WHEN status IN ('failed', 'skipped') THEN 1 ELSE 0 END) as fail
+      FROM transfer_registry
+      GROUP BY source_agent, target_agent
+    `).all();
+        const byAgentPair = new Map();
+        for (const row of pairRows) {
+            const key = `${row.source_agent}->${row.target_agent}`;
+            byAgentPair.set(key, {
+                success: row.success,
+                fail: row.fail,
+            });
+        }
+        return {
+            totalTransfers: overall.total || 0,
+            successRate: overall.total > 0 ? (overall.successes || 0) / overall.total : 0,
+            byAgentPair,
+        };
+    }
+    /**
+     * Get recent transfers within a time window
+     *
+     * @param hours - Number of hours to look back (default: 24)
+     * @returns Array of transfer records within the time window
+     *
+     * @example
+     * ```typescript
+     * // Get transfers from last 12 hours
+     * const recent = registry.getRecentTransfers(12);
+     * console.log(`${recent.length} transfers in last 12 hours`);
+     * ```
+     */
+    getRecentTransfers(hours = 24) {
+        const cutoffTime = Date.now() - (hours * 60 * 60 * 1000);
+        const rows = this.db.prepare(`
+      SELECT * FROM transfer_registry
+      WHERE timestamp >= ?
+      ORDER BY timestamp DESC
+    `).all(cutoffTime);
+        return rows.map(row => ({
+            id: row.id,
+            sourceAgent: row.source_agent,
+            targetAgent: row.target_agent,
+            patternId: row.pattern_id,
+            status: row.status,
+            reason: row.reason || undefined,
+            compatibilityScore: row.compatibility_score || undefined,
+            timestamp: new Date(row.timestamp),
+        }));
+    }
+    /**
+     * Get transfer statistics for a specific pattern
+     *
+     * Useful for tracking how well a specific pattern transfers across agents.
+     *
+     * @param patternId - Pattern identifier
+     * @returns Statistics for the pattern's transfer history
+     *
+     * @example
+     * ```typescript
+     * const stats = registry.getPatternStats('pattern-123');
+     * console.log(`Pattern transferred ${stats.total} times with ${stats.successRate * 100}% success`);
+     * ```
+     */
+    getPatternStats(patternId) {
+        const stats = this.db.prepare(`
+      SELECT
+        COUNT(*) as total,
+        SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END) as successes
+      FROM transfer_registry
+      WHERE pattern_id = ?
+    `).get(patternId);
+        const agents = this.db.prepare(`
+      SELECT DISTINCT target_agent FROM transfer_registry
+      WHERE pattern_id = ? AND status = 'success'
+    `).all(patternId).map((row) => row.target_agent);
+        return {
+            total: stats.total || 0,
+            successRate: stats.total > 0 ? (stats.successes || 0) / stats.total : 0,
+            agents,
+        };
+    }
+    /**
+     * Get most successful transfer pairs
+     *
+     * Identifies agent pairs with the highest transfer success rates.
+     *
+     * @param limit - Maximum number of pairs to return (default: 10)
+     * @param minTransfers - Minimum number of transfers required (default: 5)
+     * @returns Array of agent pairs sorted by success rate
+     *
+     * @example
+     * ```typescript
+     * const topPairs = registry.getTopTransferPairs(5, 10);
+     * topPairs.forEach(pair => {
+     *   console.log(`${pair.sourceAgent} -> ${pair.targetAgent}: ${(pair.successRate * 100).toFixed(1)}%`);
+     * });
+     * ```
+     */
+    getTopTransferPairs(limit = 10, minTransfers = 5) {
+        const rows = this.db.prepare(`
+      SELECT
+        source_agent,
+        target_agent,
+        COUNT(*) as total,
+        SUM(CASE WHEN status = 'success' THEN 1 ELSE 0 END) as successes
+      FROM transfer_registry
+      GROUP BY source_agent, target_agent
+      HAVING total >= ?
+      ORDER BY (1.0 * successes / total) DESC, total DESC
+      LIMIT ?
+    `).all(minTransfers, limit);
+        return rows.map(row => ({
+            sourceAgent: row.source_agent,
+            targetAgent: row.target_agent,
+            successRate: row.successes / row.total,
+            totalTransfers: row.total,
+        }));
+    }
+    /**
+     * Clear old transfer records
+     *
+     * Removes records older than the specified number of days.
+     * Useful for maintaining database size.
+     *
+     * @param daysToKeep - Number of days of history to retain (default: 90)
+     * @returns Number of records deleted
+     *
+     * @example
+     * ```typescript
+     * const deleted = registry.clearOldRecords(30);
+     * console.log(`Deleted ${deleted} records older than 30 days`);
+     * ```
+     */
+    clearOldRecords(daysToKeep = 90) {
+        const cutoffTime = Date.now() - (daysToKeep * 24 * 60 * 60 * 1000);
+        const result = this.db.prepare(`
+      DELETE FROM transfer_registry
+      WHERE timestamp < ?
+    `).run(cutoffTime);
+        this.logger.info('[TransferRegistry] Cleared old records', {
+            deleted: result.changes,
+            daysToKeep,
+        });
+        return result.changes;
+    }
+    /**
+     * Close database connection
+     *
+     * Should be called when registry is no longer needed to release resources.
+     *
+     * @example
+     * ```typescript
+     * registry.close();
+     * ```
+     */
+    close() {
+        this.db.close();
+        this.logger.debug('[TransferRegistry] Database closed');
+    }
+}
+exports.TransferRegistry = TransferRegistry;
+exports.default = TransferRegistry;
+//# sourceMappingURL=TransferRegistry.js.map

package/dist/learning/transfer/TransferRegistry.js.map

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