agentic-qe 2.3.4 → 2.4.0

package/dist/learning/capture/ExperienceStore.d.ts

@@ -0,0 +1,196 @@
+/**
+ * ExperienceStore - Storage layer for captured agent experiences
+ *
+ * Provides efficient storage and retrieval of captured experiences using SQLite.
+ * Supports batch operations, filtering, and automatic cleanup via TTL.
+ *
+ * Part of the Nightly-Learner Phase 1 implementation.
+ *
+ * @version 1.0.0
+ * @module src/learning/capture/ExperienceStore
+ */
+import BetterSqlite3 from 'better-sqlite3';
+import { CapturedExperience } from './ExperienceCapture';
+export interface ExperienceStoreConfig {
+    /** Database path. Default: .agentic-qe/memory.db */
+    dbPath?: string;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export interface ExperienceQueryOptions {
+    /** Maximum number of results */
+    limit?: number;
+    /** Skip first N results */
+    offset?: number;
+    /** Filter by processed status */
+    processed?: boolean;
+    /** Order by field (created_at, quality_score) */
+    orderBy?: 'created_at' | 'quality_score';
+    /** Sort direction */
+    orderDir?: 'ASC' | 'DESC';
+}
+export interface ExperienceStats {
+    total: number;
+    processed: number;
+    unprocessed: number;
+    byAgentType: Record<string, number>;
+    byTaskType: Record<string, number>;
+    avgQualityScore: number;
+    successRate: number;
+}
+/**
+ * ExperienceStore manages persistent storage of captured experiences
+ *
+ * @example
+ * ```typescript
+ * const store = new ExperienceStore({ dbPath: '.agentic-qe/memory.db' });
+ *
+ * // Store experiences
+ * await store.store(experience);
+ * await store.storeBatch(experiences);
+ *
+ * // Query experiences
+ * const recent = store.getRecent(24);
+ * const unprocessed = store.getUnprocessed(100);
+ *
+ * // Mark as processed
+ * store.markProcessed(['exp-1', 'exp-2']);
+ *
+ * // Cleanup old data
+ * store.cleanup(30); // Remove experiences older than 30 days
+ * ```
+ */
+export declare class ExperienceStore {
+    private db;
+    private logger;
+    private config;
+    /**
+     * Create a new ExperienceStore
+     *
+     * @param config - Store configuration
+     */
+    constructor(config?: ExperienceStoreConfig);
+    /**
+     * Initialize database schema for experience storage
+     */
+    private initializeSchema;
+    /**
+     * Store a single experience
+     *
+     * @param experience - Experience to store
+     * @returns Promise that resolves when stored
+     */
+    store(experience: CapturedExperience): Promise<void>;
+    /**
+     * Store multiple experiences in a batch
+     *
+     * @param experiences - Experiences to store
+     * @returns Number of experiences stored
+     */
+    storeBatch(experiences: CapturedExperience[]): Promise<number>;
+    /**
+     * Get experiences by agent type
+     *
+     * @param agentType - Agent type to filter by
+     * @param limit - Maximum number of results (default: 100)
+     * @returns Array of experiences
+     */
+    getByAgentType(agentType: string, limit?: number): CapturedExperience[];
+    /**
+     * Get experiences by task type
+     *
+     * @param taskType - Task type to filter by
+     * @param limit - Maximum number of results (default: 100)
+     * @returns Array of experiences
+     */
+    getByTaskType(taskType: string, limit?: number): CapturedExperience[];
+    /**
+     * Get unprocessed experiences
+     *
+     * @param limit - Maximum number of results (default: 100)
+     * @returns Array of unprocessed experiences
+     */
+    getUnprocessed(limit?: number): CapturedExperience[];
+    /**
+     * Mark experiences as processed
+     *
+     * @param ids - Experience IDs to mark as processed
+     */
+    markProcessed(ids: string[]): void;
+    /**
+     * Get recent experiences within a time window
+     *
+     * @param hours - Number of hours to look back (default: 24)
+     * @param limit - Maximum number of results (default: 100)
+     * @returns Array of recent experiences
+     */
+    getRecent(hours?: number, limit?: number): CapturedExperience[];
+    /**
+     * Get experiences within a date range
+     *
+     * @param startDate - Start of date range
+     * @param endDate - End of date range
+     * @param options - Query options
+     * @returns Array of experiences
+     */
+    getByDateRange(startDate: Date, endDate: Date, options?: ExperienceQueryOptions): CapturedExperience[];
+    /**
+     * Get top performing experiences by quality score
+     *
+     * @param limit - Maximum number of results (default: 10)
+     * @returns Array of high-quality experiences
+     */
+    getTopPerforming(limit?: number): CapturedExperience[];
+    /**
+     * Get experiences by ID
+     *
+     * @param ids - Experience IDs to retrieve
+     * @returns Array of experiences
+     */
+    getByIds(ids: string[]): CapturedExperience[];
+    /**
+     * Get storage statistics
+     *
+     * @returns Storage statistics
+     */
+    getStats(): ExperienceStats;
+    /**
+     * Count experiences matching criteria
+     *
+     * @param agentType - Optional agent type filter
+     * @param taskType - Optional task type filter
+     * @param processed - Optional processed status filter
+     * @returns Count of matching experiences
+     */
+    count(agentType?: string, taskType?: string, processed?: boolean): number;
+    /**
+     * Delete experiences older than specified days (TTL cleanup)
+     *
+     * @param days - Delete experiences older than this many days
+     * @returns Number of experiences deleted
+     */
+    cleanup(days?: number): number;
+    /**
+     * Delete all experiences (for testing)
+     */
+    clear(): void;
+    /**
+     * Convert database row to CapturedExperience
+     *
+     * @param row - Database row
+     * @returns CapturedExperience object
+     */
+    private rowToExperience;
+    /**
+     * Close database connection
+     */
+    close(): void;
+    /**
+     * Get database instance (for advanced queries)
+     *
+     * @returns Database instance
+     */
+    getDatabase(): BetterSqlite3.Database;
+}
+export default ExperienceStore;
+//# sourceMappingURL=ExperienceStore.d.ts.map

package/dist/learning/capture/ExperienceStore.d.ts.map

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

package/dist/learning/capture/ExperienceStore.js

@@ -0,0 +1,453 @@
+"use strict";
+/**
+ * ExperienceStore - Storage layer for captured agent experiences
+ *
+ * Provides efficient storage and retrieval of captured experiences using SQLite.
+ * Supports batch operations, filtering, and automatic cleanup via TTL.
+ *
+ * Part of the Nightly-Learner Phase 1 implementation.
+ *
+ * @version 1.0.0
+ * @module src/learning/capture/ExperienceStore
+ */
+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.ExperienceStore = void 0;
+const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const Logger_1 = require("../../utils/Logger");
+/**
+ * ExperienceStore manages persistent storage of captured experiences
+ *
+ * @example
+ * ```typescript
+ * const store = new ExperienceStore({ dbPath: '.agentic-qe/memory.db' });
+ *
+ * // Store experiences
+ * await store.store(experience);
+ * await store.storeBatch(experiences);
+ *
+ * // Query experiences
+ * const recent = store.getRecent(24);
+ * const unprocessed = store.getUnprocessed(100);
+ *
+ * // Mark as processed
+ * store.markProcessed(['exp-1', 'exp-2']);
+ *
+ * // Cleanup old data
+ * store.cleanup(30); // Remove experiences older than 30 days
+ * ```
+ */
+class ExperienceStore {
+    /**
+     * Create a new ExperienceStore
+     *
+     * @param config - Store configuration
+     */
+    constructor(config) {
+        this.logger = Logger_1.Logger.getInstance();
+        this.config = {
+            dbPath: config?.dbPath || path.join(process.cwd(), '.agentic-qe', 'memory.db'),
+            debug: config?.debug ?? false,
+        };
+        // Ensure the directory exists before opening the database
+        const dbDir = path.dirname(this.config.dbPath);
+        if (!fs.existsSync(dbDir)) {
+            fs.mkdirSync(dbDir, { recursive: true });
+        }
+        this.db = new better_sqlite3_1.default(this.config.dbPath);
+        this.initializeSchema();
+        if (this.config.debug) {
+            this.logger.debug('[ExperienceStore] Initialized', { dbPath: this.config.dbPath });
+        }
+    }
+    /**
+     * Initialize database schema for experience storage
+     */
+    initializeSchema() {
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS captured_experiences (
+        id TEXT PRIMARY KEY,
+        agent_id TEXT NOT NULL,
+        agent_type TEXT NOT NULL,
+        task_type TEXT NOT NULL,
+        execution TEXT NOT NULL,
+        context TEXT NOT NULL,
+        outcome TEXT NOT NULL,
+        embedding BLOB,
+        created_at INTEGER NOT NULL,
+        processed INTEGER DEFAULT 0
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_exp_agent_type ON captured_experiences(agent_type);
+      CREATE INDEX IF NOT EXISTS idx_exp_task_type ON captured_experiences(task_type);
+      CREATE INDEX IF NOT EXISTS idx_exp_created_at ON captured_experiences(created_at);
+      CREATE INDEX IF NOT EXISTS idx_exp_processed ON captured_experiences(processed);
+      CREATE INDEX IF NOT EXISTS idx_exp_quality ON captured_experiences(json_extract(outcome, '$.quality_score'));
+    `);
+    }
+    /**
+     * Store a single experience
+     *
+     * @param experience - Experience to store
+     * @returns Promise that resolves when stored
+     */
+    async store(experience) {
+        const stmt = this.db.prepare(`
+      INSERT OR REPLACE INTO captured_experiences
+      (id, agent_id, agent_type, task_type, execution, context, outcome, embedding, created_at, processed)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 0)
+    `);
+        stmt.run(experience.id, experience.agentId, experience.agentType, experience.taskType, JSON.stringify(experience.execution), JSON.stringify(experience.context), JSON.stringify(experience.outcome), experience.embedding ? Buffer.from(new Float32Array(experience.embedding).buffer) : null, experience.timestamp.getTime());
+        if (this.config.debug) {
+            this.logger.debug('[ExperienceStore] Stored experience', {
+                id: experience.id,
+                agentType: experience.agentType,
+                taskType: experience.taskType,
+            });
+        }
+    }
+    /**
+     * Store multiple experiences in a batch
+     *
+     * @param experiences - Experiences to store
+     * @returns Number of experiences stored
+     */
+    async storeBatch(experiences) {
+        if (experiences.length === 0)
+            return 0;
+        const stmt = this.db.prepare(`
+      INSERT OR REPLACE INTO captured_experiences
+      (id, agent_id, agent_type, task_type, execution, context, outcome, embedding, created_at, processed)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, 0)
+    `);
+        const insertMany = this.db.transaction((exps) => {
+            for (const exp of exps) {
+                stmt.run(exp.id, exp.agentId, exp.agentType, exp.taskType, JSON.stringify(exp.execution), JSON.stringify(exp.context), JSON.stringify(exp.outcome), exp.embedding ? Buffer.from(new Float32Array(exp.embedding).buffer) : null, exp.timestamp.getTime());
+            }
+            return exps.length;
+        });
+        const count = insertMany(experiences);
+        this.logger.info('[ExperienceStore] Batch stored', { count });
+        return count;
+    }
+    /**
+     * Get experiences by agent type
+     *
+     * @param agentType - Agent type to filter by
+     * @param limit - Maximum number of results (default: 100)
+     * @returns Array of experiences
+     */
+    getByAgentType(agentType, limit = 100) {
+        const rows = this.db.prepare(`
+      SELECT * FROM captured_experiences
+      WHERE agent_type = ?
+      ORDER BY created_at DESC
+      LIMIT ?
+    `).all(agentType, limit);
+        return rows.map(row => this.rowToExperience(row));
+    }
+    /**
+     * Get experiences by task type
+     *
+     * @param taskType - Task type to filter by
+     * @param limit - Maximum number of results (default: 100)
+     * @returns Array of experiences
+     */
+    getByTaskType(taskType, limit = 100) {
+        const rows = this.db.prepare(`
+      SELECT * FROM captured_experiences
+      WHERE task_type = ?
+      ORDER BY created_at DESC
+      LIMIT ?
+    `).all(taskType, limit);
+        return rows.map(row => this.rowToExperience(row));
+    }
+    /**
+     * Get unprocessed experiences
+     *
+     * @param limit - Maximum number of results (default: 100)
+     * @returns Array of unprocessed experiences
+     */
+    getUnprocessed(limit = 100) {
+        const rows = this.db.prepare(`
+      SELECT * FROM captured_experiences
+      WHERE processed = 0
+      ORDER BY created_at ASC
+      LIMIT ?
+    `).all(limit);
+        return rows.map(row => this.rowToExperience(row));
+    }
+    /**
+     * Mark experiences as processed
+     *
+     * @param ids - Experience IDs to mark as processed
+     */
+    markProcessed(ids) {
+        if (ids.length === 0)
+            return;
+        const stmt = this.db.prepare(`
+      UPDATE captured_experiences SET processed = 1 WHERE id = ?
+    `);
+        const updateMany = this.db.transaction((expIds) => {
+            for (const id of expIds) {
+                stmt.run(id);
+            }
+        });
+        updateMany(ids);
+        this.logger.info('[ExperienceStore] Marked processed', { count: ids.length });
+    }
+    /**
+     * Get recent experiences within a time window
+     *
+     * @param hours - Number of hours to look back (default: 24)
+     * @param limit - Maximum number of results (default: 100)
+     * @returns Array of recent experiences
+     */
+    getRecent(hours = 24, limit = 100) {
+        const since = Date.now() - hours * 60 * 60 * 1000;
+        const rows = this.db.prepare(`
+      SELECT * FROM captured_experiences
+      WHERE created_at >= ?
+      ORDER BY created_at DESC
+      LIMIT ?
+    `).all(since, limit);
+        return rows.map(row => this.rowToExperience(row));
+    }
+    /**
+     * Get experiences within a date range
+     *
+     * @param startDate - Start of date range
+     * @param endDate - End of date range
+     * @param options - Query options
+     * @returns Array of experiences
+     */
+    getByDateRange(startDate, endDate, options) {
+        const { limit = 100, offset = 0, processed, orderBy = 'created_at', orderDir = 'DESC', } = options || {};
+        let query = `
+      SELECT * FROM captured_experiences
+      WHERE created_at >= ? AND created_at <= ?
+    `;
+        const params = [startDate.getTime(), endDate.getTime()];
+        if (processed !== undefined) {
+            query += ` AND processed = ?`;
+            params.push(processed ? 1 : 0);
+        }
+        query += ` ORDER BY ${orderBy} ${orderDir}`;
+        query += ` LIMIT ? OFFSET ?`;
+        params.push(limit, offset);
+        const rows = this.db.prepare(query).all(...params);
+        return rows.map(row => this.rowToExperience(row));
+    }
+    /**
+     * Get top performing experiences by quality score
+     *
+     * @param limit - Maximum number of results (default: 10)
+     * @returns Array of high-quality experiences
+     */
+    getTopPerforming(limit = 10) {
+        const rows = this.db.prepare(`
+      SELECT * FROM captured_experiences
+      WHERE json_extract(outcome, '$.quality_score') >= 0.7
+      ORDER BY json_extract(outcome, '$.quality_score') DESC
+      LIMIT ?
+    `).all(limit);
+        return rows.map(row => this.rowToExperience(row));
+    }
+    /**
+     * Get experiences by ID
+     *
+     * @param ids - Experience IDs to retrieve
+     * @returns Array of experiences
+     */
+    getByIds(ids) {
+        if (ids.length === 0)
+            return [];
+        const placeholders = ids.map(() => '?').join(',');
+        const rows = this.db.prepare(`
+      SELECT * FROM captured_experiences
+      WHERE id IN (${placeholders})
+    `).all(...ids);
+        return rows.map(row => this.rowToExperience(row));
+    }
+    /**
+     * Get storage statistics
+     *
+     * @returns Storage statistics
+     */
+    getStats() {
+        const totalRow = this.db.prepare('SELECT COUNT(*) as count FROM captured_experiences').get();
+        const processedRow = this.db.prepare('SELECT COUNT(*) as count FROM captured_experiences WHERE processed = 1').get();
+        const total = totalRow.count;
+        const processed = processedRow.count;
+        const unprocessed = total - processed;
+        // By agent type
+        const agentTypeRows = this.db.prepare(`
+      SELECT agent_type, COUNT(*) as count
+      FROM captured_experiences
+      GROUP BY agent_type
+    `).all();
+        const byAgentType = {};
+        for (const row of agentTypeRows) {
+            byAgentType[row.agent_type] = row.count;
+        }
+        // By task type
+        const taskTypeRows = this.db.prepare(`
+      SELECT task_type, COUNT(*) as count
+      FROM captured_experiences
+      GROUP BY task_type
+    `).all();
+        const byTaskType = {};
+        for (const row of taskTypeRows) {
+            byTaskType[row.task_type] = row.count;
+        }
+        // Average quality score
+        const qualityRow = this.db.prepare(`
+      SELECT AVG(json_extract(outcome, '$.quality_score')) as avg_score
+      FROM captured_experiences
+    `).get();
+        const avgQualityScore = qualityRow.avg_score || 0;
+        // Success rate
+        const successRow = this.db.prepare(`
+      SELECT COUNT(*) as count
+      FROM captured_experiences
+      WHERE json_extract(execution, '$.success') = 1
+    `).get();
+        const successRate = total > 0 ? successRow.count / total : 0;
+        return {
+            total,
+            processed,
+            unprocessed,
+            byAgentType,
+            byTaskType,
+            avgQualityScore,
+            successRate,
+        };
+    }
+    /**
+     * Count experiences matching criteria
+     *
+     * @param agentType - Optional agent type filter
+     * @param taskType - Optional task type filter
+     * @param processed - Optional processed status filter
+     * @returns Count of matching experiences
+     */
+    count(agentType, taskType, processed) {
+        let query = 'SELECT COUNT(*) as count FROM captured_experiences WHERE 1=1';
+        const params = [];
+        if (agentType) {
+            query += ' AND agent_type = ?';
+            params.push(agentType);
+        }
+        if (taskType) {
+            query += ' AND task_type = ?';
+            params.push(taskType);
+        }
+        if (processed !== undefined) {
+            query += ' AND processed = ?';
+            params.push(processed ? 1 : 0);
+        }
+        const row = this.db.prepare(query).get(...params);
+        return row.count;
+    }
+    /**
+     * Delete experiences older than specified days (TTL cleanup)
+     *
+     * @param days - Delete experiences older than this many days
+     * @returns Number of experiences deleted
+     */
+    cleanup(days = 30) {
+        const cutoffTime = Date.now() - days * 24 * 60 * 60 * 1000;
+        const result = this.db.prepare(`
+      DELETE FROM captured_experiences
+      WHERE created_at < ?
+    `).run(cutoffTime);
+        this.logger.info('[ExperienceStore] Cleanup completed', {
+            days,
+            deleted: result.changes,
+        });
+        return result.changes;
+    }
+    /**
+     * Delete all experiences (for testing)
+     */
+    clear() {
+        this.db.prepare('DELETE FROM captured_experiences').run();
+        this.logger.warn('[ExperienceStore] All experiences cleared');
+    }
+    /**
+     * Convert database row to CapturedExperience
+     *
+     * @param row - Database row
+     * @returns CapturedExperience object
+     */
+    rowToExperience(row) {
+        return {
+            id: row.id,
+            agentId: row.agent_id,
+            agentType: row.agent_type,
+            taskType: row.task_type,
+            execution: JSON.parse(row.execution),
+            context: JSON.parse(row.context),
+            outcome: JSON.parse(row.outcome),
+            timestamp: new Date(row.created_at),
+            embedding: row.embedding ? Array.from(new Float32Array(row.embedding.buffer)) : undefined,
+        };
+    }
+    /**
+     * Close database connection
+     */
+    close() {
+        this.db.close();
+        if (this.config.debug) {
+            this.logger.debug('[ExperienceStore] Closed');
+        }
+    }
+    /**
+     * Get database instance (for advanced queries)
+     *
+     * @returns Database instance
+     */
+    getDatabase() {
+        return this.db;
+    }
+}
+exports.ExperienceStore = ExperienceStore;
+exports.default = ExperienceStore;
+//# sourceMappingURL=ExperienceStore.js.map

package/dist/learning/capture/ExperienceStore.js.map

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

package/dist/learning/scheduler/SleepScheduler.d.ts

@@ -41,6 +41,8 @@ export interface SleepSchedulerConfig {
     learningBudget: Partial<LearningBudget>;
     /** Minimum time between cycles in ms. Default: 3600000 (1 hour) */
     minCycleInterval?: number;
+    /** Phase durations for sleep cycle (for testing with short durations) */
+    phaseDurations?: Partial<Record<'N1_CAPTURE' | 'N2_PROCESS' | 'N3_CONSOLIDATE' | 'REM_DREAM', number>>;
     /** Enable debug logging */
     debug?: boolean;
 }