agentic-qe 2.3.3 → 2.3.5

package/dist/learning/scheduler/SleepScheduler.js

@@ -0,0 +1,301 @@
+"use strict";
+/**
+ * SleepScheduler - Orchestrates learning cycles during system idle periods
+ *
+ * Triggers learning activities when the system is idle, using either:
+ * - Idle detection (CPU/memory monitoring)
+ * - Time-based scheduling (cron-like)
+ * - Hybrid mode (both)
+ *
+ * Part of the Nightly-Learner Phase 1 implementation.
+ *
+ * @version 1.0.0
+ * @module src/learning/scheduler/SleepScheduler
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SleepScheduler = void 0;
+const events_1 = require("events");
+const IdleDetector_1 = require("./IdleDetector");
+const SleepCycle_1 = require("./SleepCycle");
+const Logger_1 = require("../../utils/Logger");
+/**
+ * SleepScheduler orchestrates learning cycles during idle periods
+ *
+ * @example
+ * ```typescript
+ * const scheduler = new SleepScheduler({
+ *   mode: 'hybrid',
+ *   learningBudget: { maxPatternsPerCycle: 50, maxAgentsPerCycle: 5 },
+ * });
+ *
+ * scheduler.on('sleep:start', (cycle) => console.log('Learning cycle started'));
+ * scheduler.on('sleep:end', (summary) => console.log('Cycle complete:', summary));
+ *
+ * await scheduler.start();
+ * ```
+ */
+class SleepScheduler extends events_1.EventEmitter {
+    constructor(config) {
+        super();
+        this.currentCycle = null;
+        this.isRunning = false;
+        this.timeBasedTimer = null;
+        this.lastCycleEnd = null;
+        this.cyclesCompleted = 0;
+        this.totalPatternsProcessed = 0;
+        this.totalAgentsProcessed = 0;
+        this.logger = Logger_1.Logger.getInstance();
+        // Apply defaults
+        this.config = {
+            mode: config.mode,
+            idleConfig: {
+                cpuThreshold: 20,
+                memoryThreshold: 70,
+                taskQueueEmpty: true,
+                minIdleDuration: 60000,
+                checkInterval: 10000,
+                debug: config.debug ?? false,
+                ...config.idleConfig,
+            },
+            schedule: {
+                startHour: 2,
+                durationMinutes: 60,
+                daysOfWeek: [0, 1, 2, 3, 4, 5, 6],
+                ...config.schedule,
+            },
+            learningBudget: {
+                maxPatternsPerCycle: 50,
+                maxAgentsPerCycle: 5,
+                maxDurationMs: 3600000,
+                ...config.learningBudget,
+            },
+            minCycleInterval: config.minCycleInterval ?? 3600000,
+            phaseDurations: config.phaseDurations,
+            debug: config.debug ?? false,
+        };
+        this.idleDetector = new IdleDetector_1.IdleDetector(this.config.idleConfig);
+    }
+    /**
+     * Start the sleep scheduler
+     */
+    async start() {
+        if (this.isRunning) {
+            this.logger.warn('[SleepScheduler] Already running');
+            return;
+        }
+        this.isRunning = true;
+        this.logger.info('[SleepScheduler] Starting', {
+            mode: this.config.mode,
+            budget: this.config.learningBudget,
+        });
+        // Set up idle-based triggering
+        if (this.config.mode === 'idle' || this.config.mode === 'hybrid') {
+            this.idleDetector.on('idle:detected', this.handleIdleDetected.bind(this));
+            await this.idleDetector.start();
+            this.logger.info('[SleepScheduler] Idle detection enabled');
+        }
+        // Set up time-based triggering
+        if (this.config.mode === 'time' || this.config.mode === 'hybrid') {
+            this.scheduleTimeBased();
+            this.logger.info('[SleepScheduler] Time-based scheduling enabled', {
+                startHour: this.config.schedule.startHour,
+                durationMinutes: this.config.schedule.durationMinutes,
+            });
+        }
+        this.emit('scheduler:started', this.getState());
+    }
+    /**
+     * Stop the sleep scheduler
+     */
+    async stop() {
+        if (!this.isRunning)
+            return;
+        this.logger.info('[SleepScheduler] Stopping');
+        this.isRunning = false;
+        // Stop idle detection
+        await this.idleDetector.stop();
+        // Clear time-based timer
+        if (this.timeBasedTimer) {
+            clearTimeout(this.timeBasedTimer);
+            this.timeBasedTimer = null;
+        }
+        // Abort current cycle if active
+        if (this.currentCycle?.isActive) {
+            await this.currentCycle.abort();
+        }
+        this.emit('scheduler:stopped', this.getState());
+    }
+    /**
+     * Manually trigger a learning cycle
+     */
+    async triggerCycle(reason = 'manual') {
+        if (!this.isRunning) {
+            this.logger.warn('[SleepScheduler] Cannot trigger cycle - scheduler not running');
+            return null;
+        }
+        if (this.currentCycle?.isActive) {
+            this.logger.warn('[SleepScheduler] Cycle already in progress');
+            return null;
+        }
+        this.logger.info('[SleepScheduler] Manual cycle triggered', { reason });
+        return await this.executeCycle(reason);
+    }
+    /**
+     * Get current scheduler state
+     */
+    getState() {
+        return {
+            isRunning: this.isRunning,
+            mode: this.config.mode,
+            currentCycle: this.currentCycle,
+            lastCycleEnd: this.lastCycleEnd,
+            cyclesCompleted: this.cyclesCompleted,
+            totalPatternsProcessed: this.totalPatternsProcessed,
+            totalAgentsProcessed: this.totalAgentsProcessed,
+            nextScheduledRun: this.getNextScheduledRun(),
+        };
+    }
+    /**
+     * Register a task to prevent idle detection during critical operations
+     */
+    registerTask(taskId) {
+        this.idleDetector.registerTask(taskId);
+    }
+    /**
+     * Unregister a task to allow idle detection
+     */
+    unregisterTask(taskId) {
+        this.idleDetector.unregisterTask(taskId);
+    }
+    /**
+     * Handle idle detection event
+     */
+    async handleIdleDetected(state) {
+        // Check if we're within minimum cycle interval
+        if (this.lastCycleEnd) {
+            const timeSinceLastCycle = Date.now() - this.lastCycleEnd.getTime();
+            if (timeSinceLastCycle < this.config.minCycleInterval) {
+                this.logger.debug('[SleepScheduler] Skipping cycle - too soon since last', {
+                    timeSinceLastCycle,
+                    minInterval: this.config.minCycleInterval,
+                });
+                return;
+            }
+        }
+        this.logger.info('[SleepScheduler] Idle detected, triggering cycle', {
+            idleDuration: state.idleDuration,
+            cpu: state.cpuUsage.toFixed(1) + '%',
+            memory: state.memoryUsage.toFixed(1) + '%',
+        });
+        await this.executeCycle('idle');
+    }
+    /**
+     * Execute a learning cycle
+     */
+    async executeCycle(trigger) {
+        const cycleConfig = {
+            budget: this.config.learningBudget,
+            phaseDurations: this.config.phaseDurations,
+            debug: this.config.debug,
+        };
+        this.currentCycle = new SleepCycle_1.SleepCycle(cycleConfig);
+        // Forward cycle events
+        this.currentCycle.on('phase:start', (phase) => {
+            this.emit('sleep:phase', phase);
+        });
+        this.currentCycle.on('phase:complete', (phase, result) => {
+            this.emit('sleep:phase:complete', phase, result);
+        });
+        this.emit('sleep:start', {
+            cycle: this.currentCycle,
+            trigger,
+            timestamp: new Date(),
+        });
+        try {
+            const summary = await this.currentCycle.execute();
+            this.lastCycleEnd = new Date();
+            this.cyclesCompleted++;
+            this.totalPatternsProcessed += summary.patternsDiscovered + summary.patternsConsolidated;
+            this.totalAgentsProcessed += summary.agentsProcessed.length;
+            this.emit('sleep:end', summary);
+            this.logger.info('[SleepScheduler] Cycle completed', {
+                duration: summary.endTime.getTime() - summary.startTime.getTime(),
+                patternsDiscovered: summary.patternsDiscovered,
+                patternsConsolidated: summary.patternsConsolidated,
+                agentsProcessed: summary.agentsProcessed.length,
+                errors: summary.errors.length,
+            });
+            return summary;
+        }
+        catch (error) {
+            this.logger.error('[SleepScheduler] Cycle failed', error);
+            this.emit('error', error);
+            throw error;
+        }
+        finally {
+            this.currentCycle = null;
+        }
+    }
+    /**
+     * Set up time-based scheduling
+     */
+    scheduleTimeBased() {
+        const scheduleNext = () => {
+            const nextRun = this.getNextScheduledRun();
+            if (!nextRun)
+                return;
+            const delay = nextRun.getTime() - Date.now();
+            this.logger.debug('[SleepScheduler] Next scheduled run', {
+                nextRun: nextRun.toISOString(),
+                delayMs: delay,
+            });
+            this.timeBasedTimer = setTimeout(async () => {
+                if (!this.isRunning)
+                    return;
+                // Check if today is a scheduled day
+                const today = new Date().getDay();
+                if (this.config.schedule.daysOfWeek?.includes(today)) {
+                    try {
+                        await this.executeCycle('scheduled');
+                    }
+                    catch (error) {
+                        this.logger.error('[SleepScheduler] Scheduled cycle failed', error);
+                    }
+                }
+                // Schedule next run
+                scheduleNext();
+            }, delay);
+        };
+        scheduleNext();
+    }
+    /**
+     * Calculate next scheduled run time
+     */
+    getNextScheduledRun() {
+        if (this.config.mode === 'idle')
+            return null;
+        const now = new Date();
+        const nextRun = new Date(now);
+        // Set to scheduled hour
+        nextRun.setHours(this.config.schedule?.startHour ?? 2, 0, 0, 0);
+        // If that time has passed today, schedule for tomorrow
+        if (nextRun <= now) {
+            nextRun.setDate(nextRun.getDate() + 1);
+        }
+        // Find next valid day
+        const daysOfWeek = this.config.schedule.daysOfWeek || [0, 1, 2, 3, 4, 5, 6];
+        while (!daysOfWeek.includes(nextRun.getDay())) {
+            nextRun.setDate(nextRun.getDate() + 1);
+        }
+        return nextRun;
+    }
+    /**
+     * Get configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+}
+exports.SleepScheduler = SleepScheduler;
+exports.default = SleepScheduler;
+//# sourceMappingURL=SleepScheduler.js.map

package/dist/learning/scheduler/SleepScheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SleepScheduler.js","sourceRoot":"","sources":["../../../src/learning/scheduler/SleepScheduler.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAEH,mCAAsC;AACtC,iDAA6E;AAC7E,6CAAsF;AACtF,+CAA4C;AAgD5C;;;;;;;;;;;;;;;GAeG;AACH,MAAa,cAAe,SAAQ,qBAAY;IAY9C,YAAY,MAA4B;QACtC,KAAK,EAAE,CAAC;QAVF,iBAAY,GAAsB,IAAI,CAAC;QACvC,cAAS,GAAY,KAAK,CAAC;QAE3B,mBAAc,GAA0B,IAAI,CAAC;QAC7C,iBAAY,GAAgB,IAAI,CAAC;QACjC,oBAAe,GAAW,CAAC,CAAC;QAC5B,2BAAsB,GAAW,CAAC,CAAC;QACnC,yBAAoB,GAAW,CAAC,CAAC;QAIvC,IAAI,CAAC,MAAM,GAAG,eAAM,CAAC,WAAW,EAAE,CAAC;QAEnC,iBAAiB;QACjB,IAAI,CAAC,MAAM,GAAG;YACZ,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,UAAU,EAAE;gBACV,YAAY,EAAE,EAAE;gBAChB,eAAe,EAAE,EAAE;gBACnB,cAAc,EAAE,IAAI;gBACpB,eAAe,EAAE,KAAK;gBACtB,aAAa,EAAE,KAAK;gBACpB,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,KAAK;gBAC5B,GAAG,MAAM,CAAC,UAAU;aACrB;YACD,QAAQ,EAAE;gBACR,SAAS,EAAE,CAAC;gBACZ,eAAe,EAAE,EAAE;gBACnB,UAAU,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBACjC,GAAG,MAAM,CAAC,QAAQ;aACnB;YACD,cAAc,EAAE;gBACd,mBAAmB,EAAE,EAAE;gBACvB,iBAAiB,EAAE,CAAC;gBACpB,aAAa,EAAE,OAAO;gBACtB,GAAG,MAAM,CAAC,cAAc;aACzB;YACD,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,OAAO;YACpD,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,KAAK;SAC7B,CAAC;QAEF,IAAI,CAAC,YAAY,GAAG,IAAI,2BAAY,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IAC/D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;YACrD,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;YAC5C,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACtB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;SACnC,CAAC,CAAC;QAEH,+BAA+B;QAC/B,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjE,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,eAAe,EAAE,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;YAC1E,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QAC9D,CAAC;QAED,+BAA+B;QAC/B,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjE,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACzB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gDAAgD,EAAE;gBACjE,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS;gBACzC,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe;aACtD,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,IAAI;QACR,IAAI,CAAC,IAAI,CAAC,SAAS;YAAE,OAAO;QAE5B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC9C,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC;QAEvB,sBAAsB;QACtB,MAAM,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;QAE/B,yBAAyB;QACzB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAClC,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC;QAC7B,CAAC;QAED,gCAAgC;QAChC,IAAI,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,CAAC;YAChC,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAClC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,mBAAmB,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,SAAiB,QAAQ;QAC1C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;YAClF,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,CAAC;YAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC;YAC/D,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yCAAyC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACxE,OAAO,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,QAAQ;QACN,OAAO;YACL,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACtB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;YACnD,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,gBAAgB,EAAE,IAAI,CAAC,mBAAmB,EAAE;SAC7C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,MAAc;QACzB,IAAI,CAAC,YAAY,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,cAAc,CAAC,MAAc;QAC3B,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,kBAAkB,CAAC,KAAgB;QAC/C,+CAA+C;QAC/C,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,MAAM,kBAAkB,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YACpE,IAAI,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;gBACtD,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uDAAuD,EAAE;oBACzE,kBAAkB;oBAClB,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,gBAAgB;iBAC1C,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kDAAkD,EAAE;YACnE,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,GAAG,EAAE,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG;YACpC,MAAM,EAAE,KAAK,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG;SAC3C,CAAC,CAAC;QAEH,MAAM,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CAAC,OAAe;QACxC,MAAM,WAAW,GAAqB;YACpC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,cAAgC;YACpD,cAAc,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;YAC1C,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK;SACzB,CAAC;QAEF,IAAI,CAAC,YAAY,GAAG,IAAI,uBAAU,CAAC,WAAW,CAAC,CAAC;QAEhD,uBAAuB;QACvB,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,EAAE;YAC5C,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE;YACvD,IAAI,CAAC,IAAI,CAAC,sBAAsB,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEH,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE;YACvB,KAAK,EAAE,IAAI,CAAC,YAAY;YACxB,OAAO;YACP,SAAS,EAAE,IAAI,IAAI,EAAE;SACtB,CAAC,CAAC;QAEH,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YAElD,IAAI,CAAC,YAAY,GAAG,IAAI,IAAI,EAAE,CAAC;YAC/B,IAAI,CAAC,eAAe,EAAE,CAAC;YACvB,IAAI,CAAC,sBAAsB,IAAI,OAAO,CAAC,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;YACzF,IAAI,CAAC,oBAAoB,IAAI,OAAO,CAAC,eAAe,CAAC,MAAM,CAAC;YAE5D,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YAEhC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE;gBACnD,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,EAAE;gBACjE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;gBAC9C,oBAAoB,EAAE,OAAO,CAAC,oBAAoB;gBAClD,eAAe,EAAE,OAAO,CAAC,eAAe,CAAC,MAAM;gBAC/C,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM;aAC9B,CAAC,CAAC;YAEH,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;YAC1D,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YAC1B,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,iBAAiB;QACvB,MAAM,YAAY,GAAG,GAAG,EAAE;YACxB,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,EAAE,CAAC;YAC3C,IAAI,CAAC,OAAO;gBAAE,OAAO;YAErB,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE7C,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,qCAAqC,EAAE;gBACvD,OAAO,EAAE,OAAO,CAAC,WAAW,EAAE;gBAC9B,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;YAEH,IAAI,CAAC,cAAc,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE;gBAC1C,IAAI,CAAC,IAAI,CAAC,SAAS;oBAAE,OAAO;gBAE5B,oCAAoC;gBACpC,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC;gBAClC,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;oBACrD,IAAI,CAAC;wBACH,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;oBACvC,CAAC;oBAAC,OAAO,KAAK,EAAE,CAAC;wBACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,yCAAyC,EAAE,KAAK,CAAC,CAAC;oBACtE,CAAC;gBACH,CAAC;gBAED,oBAAoB;gBACpB,YAAY,EAAE,CAAC;YACjB,CAAC,EAAE,KAAK,CAAC,CAAC;QACZ,CAAC,CAAC;QAEF,YAAY,EAAE,CAAC;IACjB,CAAC;IAED;;OAEG;IACK,mBAAmB;QACzB,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM;YAAE,OAAO,IAAI,CAAC;QAE7C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;QAE9B,wBAAwB;QACxB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAEhE,uDAAuD;QACvD,IAAI,OAAO,IAAI,GAAG,EAAE,CAAC;YACnB,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,sBAAsB;QACtB,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,IAAI,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5E,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC;YAC9C,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QACzC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;IAC5B,CAAC;CACF;AAhTD,wCAgTC;AAED,kBAAe,cAAc,CAAC"}

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

@@ -0,0 +1,108 @@
+/**
+ * TimeBasedTrigger - Cron-like scheduling for learning cycles
+ *
+ * Provides time-based triggering as a fallback or supplement to idle detection.
+ * Supports daily scheduling with configurable hours and days of week.
+ *
+ * Part of the Nightly-Learner Phase 1 implementation.
+ *
+ * @version 1.0.0
+ * @module src/learning/scheduler/TimeBasedTrigger
+ */
+import { EventEmitter } from 'events';
+export interface TimeBasedTriggerConfig {
+    /** Hour to trigger (0-23). Default: 2 (2 AM) */
+    hour: number;
+    /** Minute to trigger (0-59). Default: 0 */
+    minute?: number;
+    /** Days of week to trigger (0=Sunday, 6=Saturday). Default: all days */
+    daysOfWeek?: number[];
+    /** Timezone offset in hours. Default: 0 (UTC) */
+    timezoneOffset?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+}
+export interface TriggerEvent {
+    timestamp: Date;
+    scheduledTime: Date;
+    dayOfWeek: number;
+    triggered: boolean;
+    skipped?: string;
+}
+/**
+ * TimeBasedTrigger provides cron-like scheduling
+ *
+ * @example
+ * ```typescript
+ * const trigger = new TimeBasedTrigger({
+ *   hour: 2,
+ *   minute: 30,
+ *   daysOfWeek: [1, 2, 3, 4, 5], // Weekdays only
+ * });
+ *
+ * trigger.on('trigger', () => {
+ *   console.log('Time to learn!');
+ * });
+ *
+ * trigger.start();
+ * ```
+ */
+export declare class TimeBasedTrigger extends EventEmitter {
+    private config;
+    private logger;
+    private timer;
+    private isRunning;
+    private triggerHistory;
+    private skipNextTrigger;
+    constructor(config: TimeBasedTriggerConfig);
+    /**
+     * Start the time-based trigger
+     */
+    start(): void;
+    /**
+     * Stop the time-based trigger
+     */
+    stop(): void;
+    /**
+     * Skip the next scheduled trigger
+     */
+    skipNext(reason?: string): void;
+    /**
+     * Get the next scheduled trigger time
+     */
+    getNextTriggerTime(): Date | null;
+    /**
+     * Get time until next trigger in milliseconds
+     */
+    getTimeUntilNextTrigger(): number | null;
+    /**
+     * Get trigger history
+     */
+    getHistory(limit?: number): TriggerEvent[];
+    /**
+     * Check if a specific day is enabled
+     */
+    isDayEnabled(day: number): boolean;
+    /**
+     * Update configuration (requires restart)
+     */
+    updateConfig(config: Partial<TimeBasedTriggerConfig>): void;
+    /**
+     * Schedule the next trigger
+     */
+    private scheduleNextTrigger;
+    /**
+     * Handle a trigger event
+     */
+    private handleTrigger;
+    /**
+     * Get configuration
+     */
+    getConfig(): TimeBasedTriggerConfig;
+    /**
+     * Check if trigger is running
+     */
+    getIsRunning(): boolean;
+}
+export default TimeBasedTrigger;
+//# sourceMappingURL=TimeBasedTrigger.d.ts.map

package/dist/learning/scheduler/TimeBasedTrigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TimeBasedTrigger.d.ts","sourceRoot":"","sources":["../../../src/learning/scheduler/TimeBasedTrigger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAGtC,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,iDAAiD;IACjD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,IAAI,CAAC;IAChB,aAAa,EAAE,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAA+B;IAC5C,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,eAAe,CAAkB;gBAE7B,MAAM,EAAE,sBAAsB;IAqB1C;;OAEG;IACH,KAAK,IAAI,IAAI;IAmBb;;OAEG;IACH,IAAI,IAAI,IAAI;IAcZ;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAK/B;;OAEG;IACH,kBAAkB,IAAI,IAAI,GAAG,IAAI;IAyBjC;;OAEG;IACH,uBAAuB,IAAI,MAAM,GAAG,IAAI;IAMxC;;OAEG;IACH,UAAU,CAAC,KAAK,GAAE,MAAW,GAAG,YAAY,EAAE;IAI9C;;OAEG;IACH,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,sBAAsB,CAAC,GAAG,IAAI;IAiB3D;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAkCrB;;OAEG;IACH,SAAS,IAAI,sBAAsB;IAInC;;OAEG;IACH,YAAY,IAAI,OAAO;CAGxB;AAED,eAAe,gBAAgB,CAAC"}

package/dist/learning/scheduler/TimeBasedTrigger.js

@@ -0,0 +1,222 @@
+"use strict";
+/**
+ * TimeBasedTrigger - Cron-like scheduling for learning cycles
+ *
+ * Provides time-based triggering as a fallback or supplement to idle detection.
+ * Supports daily scheduling with configurable hours and days of week.
+ *
+ * Part of the Nightly-Learner Phase 1 implementation.
+ *
+ * @version 1.0.0
+ * @module src/learning/scheduler/TimeBasedTrigger
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimeBasedTrigger = void 0;
+const events_1 = require("events");
+const Logger_1 = require("../../utils/Logger");
+/**
+ * TimeBasedTrigger provides cron-like scheduling
+ *
+ * @example
+ * ```typescript
+ * const trigger = new TimeBasedTrigger({
+ *   hour: 2,
+ *   minute: 30,
+ *   daysOfWeek: [1, 2, 3, 4, 5], // Weekdays only
+ * });
+ *
+ * trigger.on('trigger', () => {
+ *   console.log('Time to learn!');
+ * });
+ *
+ * trigger.start();
+ * ```
+ */
+class TimeBasedTrigger extends events_1.EventEmitter {
+    constructor(config) {
+        super();
+        this.timer = null;
+        this.isRunning = false;
+        this.triggerHistory = [];
+        this.skipNextTrigger = false;
+        this.logger = Logger_1.Logger.getInstance();
+        this.config = {
+            hour: config.hour,
+            minute: config.minute ?? 0,
+            daysOfWeek: config.daysOfWeek ?? [0, 1, 2, 3, 4, 5, 6],
+            timezoneOffset: config.timezoneOffset ?? 0,
+            debug: config.debug ?? false,
+        };
+        // Validate config
+        if (this.config.hour < 0 || this.config.hour > 23) {
+            throw new Error('Hour must be between 0 and 23');
+        }
+        if (this.config.minute < 0 || this.config.minute > 59) {
+            throw new Error('Minute must be between 0 and 59');
+        }
+    }
+    /**
+     * Start the time-based trigger
+     */
+    start() {
+        if (this.isRunning) {
+            this.logger.warn('[TimeBasedTrigger] Already running');
+            return;
+        }
+        this.isRunning = true;
+        this.scheduleNextTrigger();
+        this.logger.info('[TimeBasedTrigger] Started', {
+            hour: this.config.hour,
+            minute: this.config.minute,
+            daysOfWeek: this.config.daysOfWeek,
+            nextTrigger: this.getNextTriggerTime()?.toISOString(),
+        });
+        this.emit('started');
+    }
+    /**
+     * Stop the time-based trigger
+     */
+    stop() {
+        if (!this.isRunning)
+            return;
+        this.isRunning = false;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = null;
+        }
+        this.logger.info('[TimeBasedTrigger] Stopped');
+        this.emit('stopped');
+    }
+    /**
+     * Skip the next scheduled trigger
+     */
+    skipNext(reason) {
+        this.skipNextTrigger = true;
+        this.logger.info('[TimeBasedTrigger] Next trigger will be skipped', { reason });
+    }
+    /**
+     * Get the next scheduled trigger time
+     */
+    getNextTriggerTime() {
+        if (!this.isRunning)
+            return null;
+        const now = new Date();
+        const next = new Date(now);
+        // Set to configured time
+        next.setHours(this.config.hour, this.config.minute, 0, 0);
+        // Adjust for timezone
+        next.setTime(next.getTime() - this.config.timezoneOffset * 60 * 60 * 1000);
+        // If time has passed today, move to tomorrow
+        if (next <= now) {
+            next.setDate(next.getDate() + 1);
+        }
+        // Find next valid day of week
+        while (!this.config.daysOfWeek.includes(next.getDay())) {
+            next.setDate(next.getDate() + 1);
+        }
+        return next;
+    }
+    /**
+     * Get time until next trigger in milliseconds
+     */
+    getTimeUntilNextTrigger() {
+        const next = this.getNextTriggerTime();
+        if (!next)
+            return null;
+        return Math.max(0, next.getTime() - Date.now());
+    }
+    /**
+     * Get trigger history
+     */
+    getHistory(limit = 10) {
+        return this.triggerHistory.slice(-limit);
+    }
+    /**
+     * Check if a specific day is enabled
+     */
+    isDayEnabled(day) {
+        return this.config.daysOfWeek.includes(day);
+    }
+    /**
+     * Update configuration (requires restart)
+     */
+    updateConfig(config) {
+        const wasRunning = this.isRunning;
+        if (wasRunning) {
+            this.stop();
+        }
+        this.config = {
+            ...this.config,
+            ...config,
+        };
+        if (wasRunning) {
+            this.start();
+        }
+    }
+    /**
+     * Schedule the next trigger
+     */
+    scheduleNextTrigger() {
+        const nextTime = this.getNextTriggerTime();
+        if (!nextTime)
+            return;
+        const delay = nextTime.getTime() - Date.now();
+        if (this.config.debug) {
+            this.logger.debug('[TimeBasedTrigger] Scheduling next trigger', {
+                nextTime: nextTime.toISOString(),
+                delayMs: delay,
+                delayHours: (delay / 1000 / 60 / 60).toFixed(2),
+            });
+        }
+        this.timer = setTimeout(() => this.handleTrigger(nextTime), delay);
+    }
+    /**
+     * Handle a trigger event
+     */
+    handleTrigger(scheduledTime) {
+        if (!this.isRunning)
+            return;
+        const event = {
+            timestamp: new Date(),
+            scheduledTime,
+            dayOfWeek: new Date().getDay(),
+            triggered: false,
+        };
+        // Check if we should skip this trigger
+        if (this.skipNextTrigger) {
+            event.skipped = 'Manual skip requested';
+            this.skipNextTrigger = false;
+            this.logger.info('[TimeBasedTrigger] Trigger skipped', { reason: event.skipped });
+        }
+        else if (!this.config.daysOfWeek.includes(event.dayOfWeek)) {
+            event.skipped = `Day ${event.dayOfWeek} not in schedule`;
+        }
+        else {
+            event.triggered = true;
+            this.logger.info('[TimeBasedTrigger] Triggering');
+            this.emit('trigger', event);
+        }
+        this.triggerHistory.push(event);
+        // Keep history limited
+        if (this.triggerHistory.length > 100) {
+            this.triggerHistory = this.triggerHistory.slice(-50);
+        }
+        // Schedule next trigger
+        this.scheduleNextTrigger();
+    }
+    /**
+     * Get configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Check if trigger is running
+     */
+    getIsRunning() {
+        return this.isRunning;
+    }
+}
+exports.TimeBasedTrigger = TimeBasedTrigger;
+exports.default = TimeBasedTrigger;
+//# sourceMappingURL=TimeBasedTrigger.js.map

package/dist/learning/scheduler/TimeBasedTrigger.js.map

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

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

@@ -0,0 +1,16 @@
+/**
+ * Learning Scheduler Module
+ *
+ * Provides scheduling infrastructure for the Nightly-Learner system:
+ * - IdleDetector: Monitor system idle state
+ * - SleepScheduler: Orchestrate learning cycles
+ * - SleepCycle: Execute learning phases
+ * - TimeBasedTrigger: Cron-like fallback scheduling
+ *
+ * @module src/learning/scheduler
+ */
+export { IdleDetector, IdleDetectorConfig, IdleState } from './IdleDetector';
+export { SleepScheduler, SleepSchedulerConfig, SleepSchedulerState, LearningBudget, ScheduleConfig, } from './SleepScheduler';
+export { SleepCycle, SleepCycleConfig, SleepPhase, PhaseResult, CycleSummary, } from './SleepCycle';
+export { TimeBasedTrigger, TimeBasedTriggerConfig, TriggerEvent, } from './TimeBasedTrigger';
+//# sourceMappingURL=index.d.ts.map

package/dist/learning/scheduler/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/learning/scheduler/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EACL,cAAc,EACd,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,UAAU,EACV,WAAW,EACX,YAAY,GACb,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,YAAY,GACb,MAAM,oBAAoB,CAAC"}