devchain-cli 0.13.1 → 0.14.1

package/dist/server/modules/scheduled-epics/services/scheduled-epic-runner.service.d.ts

@@ -0,0 +1,33 @@
+import { OnModuleDestroy, OnModuleInit } from '@nestjs/common';
+import { type StorageService } from '../../storage/interfaces/storage.interface';
+import type { ScheduledEpicRun } from '../../storage/models/domain.models';
+import { EpicsService } from '../../epics/services/epics.service';
+import { EventsService } from '../../events/services/events.service';
+import type { ScheduledEpicRunnerRefresh } from './scheduled-epics.service';
+export declare class ScheduledEpicRunnerService implements ScheduledEpicRunnerRefresh, OnModuleInit, OnModuleDestroy {
+    private readonly storage;
+    private readonly epicsService;
+    private readonly eventsService;
+    private wakeTimer;
+    private scanning;
+    constructor(storage: StorageService, epicsService: EpicsService, eventsService: EventsService);
+    onModuleInit(): void;
+    onModuleDestroy(): void;
+    refreshScheduleWindow(): void;
+    private scheduleNextWake;
+    private clearWakeTimer;
+    private wake;
+    private scanAndExecute;
+    private scanProject;
+    private processSchedule;
+    private computeMissedSlots;
+    private claimAndExecute;
+    private atomicClaim;
+    private drainPendingRuns;
+    executeRun(run: ScheduledEpicRun): Promise<void>;
+    private executeClaimedRun;
+    private publishRunOutcome;
+    private recoverStaleRuns;
+    private advanceNextRunAt;
+    private buildTemplateVars;
+}

package/dist/server/modules/scheduled-epics/services/scheduled-epic-runner.service.js

@@ -0,0 +1,434 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScheduledEpicRunnerService = void 0;
+const common_1 = require("@nestjs/common");
+const storage_interface_1 = require("../../storage/interfaces/storage.interface");
+const epics_service_1 = require("../../epics/services/epics.service");
+const events_service_1 = require("../../events/services/events.service");
+const logger_1 = require("../../../common/logging/logger");
+const cron_helpers_1 = require("../helpers/cron-helpers");
+const template_helpers_1 = require("../helpers/template-helpers");
+const logger = (0, logger_1.createLogger)('ScheduledEpicRunnerService');
+const SCAN_INTERVAL_MS = 60_000;
+const MIN_WAKE_MS = 1_000;
+const MAX_CATCHUP_RUNS_PER_SCAN = 10;
+const CATCHUP_HORIZON_MS = 24 * 60 * 60 * 1_000;
+const STALE_RUNNING_THRESHOLD_MS = 15 * 60 * 1_000;
+let ScheduledEpicRunnerService = class ScheduledEpicRunnerService {
+    constructor(storage, epicsService, eventsService) {
+        this.storage = storage;
+        this.epicsService = epicsService;
+        this.eventsService = eventsService;
+        this.wakeTimer = null;
+        this.scanning = false;
+    }
+    onModuleInit() {
+        this.scheduleNextWake(MIN_WAKE_MS);
+        logger.info('Runner initialized');
+    }
+    onModuleDestroy() {
+        this.clearWakeTimer();
+        logger.info('Runner destroyed');
+    }
+    refreshScheduleWindow() {
+        this.scheduleNextWake(MIN_WAKE_MS);
+    }
+    scheduleNextWake(delayMs) {
+        this.clearWakeTimer();
+        const clamped = Math.max(MIN_WAKE_MS, delayMs);
+        this.wakeTimer = setTimeout(() => this.wake(), clamped);
+    }
+    clearWakeTimer() {
+        if (this.wakeTimer) {
+            clearTimeout(this.wakeTimer);
+            this.wakeTimer = null;
+        }
+    }
+    async wake() {
+        if (this.scanning) {
+            this.scheduleNextWake(SCAN_INTERVAL_MS);
+            return;
+        }
+        this.scanning = true;
+        try {
+            await this.scanAndExecute();
+        }
+        catch (error) {
+            logger.error({ error: String(error) }, 'Scan cycle failed');
+        }
+        finally {
+            this.scanning = false;
+            this.scheduleNextWake(SCAN_INTERVAL_MS);
+        }
+    }
+    async scanAndExecute() {
+        const projects = await this.storage.listProjects({ limit: 500 });
+        for (const project of projects.items) {
+            try {
+                await this.scanProject(project.id);
+            }
+            catch (error) {
+                logger.error({ projectId: project.id, error: String(error) }, 'Failed to scan project schedules');
+            }
+        }
+    }
+    async scanProject(projectId) {
+        const now = new Date().toISOString();
+        await this.recoverStaleRuns(projectId, now);
+        const dueSchedules = await this.storage.listDueScheduledEpics(projectId, now);
+        for (const schedule of dueSchedules) {
+            try {
+                await this.processSchedule(schedule, now);
+            }
+            catch (error) {
+                logger.error({ scheduleId: schedule.id, error: String(error) }, 'Failed to process schedule');
+            }
+        }
+        const allSchedules = await this.storage.listScheduledEpics(projectId, { limit: 500 });
+        for (const schedule of allSchedules.items) {
+            try {
+                await this.drainPendingRuns(schedule.id);
+            }
+            catch (error) {
+                logger.error({ scheduleId: schedule.id, error: String(error) }, 'Failed to drain pending runs');
+            }
+        }
+    }
+    async processSchedule(schedule, now) {
+        if (!schedule.enabled || !schedule.nextRunAt)
+            return;
+        const missedSlots = this.computeMissedSlots(schedule, now);
+        if (missedSlots.length <= 1) {
+            await this.claimAndExecute(schedule, schedule.nextRunAt, 'scheduler');
+            await this.advanceNextRunAt(schedule);
+            return;
+        }
+        switch (schedule.missedRunPolicy) {
+            case 'skip':
+                logger.info({ scheduleId: schedule.id, missed: missedSlots.length }, 'Skipping missed runs per policy');
+                await this.advanceNextRunAt(schedule);
+                break;
+            case 'run_once':
+                await this.claimAndExecute(schedule, missedSlots[missedSlots.length - 1], 'scheduler');
+                await this.advanceNextRunAt(schedule);
+                break;
+            case 'run_all': {
+                const slotsToProcess = missedSlots.slice(0, MAX_CATCHUP_RUNS_PER_SCAN);
+                for (const slot of slotsToProcess) {
+                    await this.claimAndExecute(schedule, slot, 'scheduler');
+                }
+                if (missedSlots.length > MAX_CATCHUP_RUNS_PER_SCAN) {
+                    const firstUnprocessed = missedSlots[MAX_CATCHUP_RUNS_PER_SCAN];
+                    await this.storage.updateScheduledEpicRuntimeState(schedule.id, {
+                        nextRunAt: firstUnprocessed,
+                    });
+                    logger.info({
+                        scheduleId: schedule.id,
+                        processed: slotsToProcess.length,
+                        remaining: missedSlots.length - MAX_CATCHUP_RUNS_PER_SCAN,
+                        nextRunAt: firstUnprocessed,
+                    }, 'Catch-up capped, preserving backlog for next scan');
+                }
+                else {
+                    await this.advanceNextRunAt(schedule);
+                }
+                break;
+            }
+        }
+    }
+    computeMissedSlots(schedule, now) {
+        if (!schedule.nextRunAt)
+            return [];
+        const slots = [];
+        let cursor = new Date(schedule.nextRunAt);
+        const nowDate = new Date(now);
+        const horizonCutoff = new Date(nowDate.getTime() - CATCHUP_HORIZON_MS);
+        const enumerationLimit = MAX_CATCHUP_RUNS_PER_SCAN * 10;
+        while (cursor <= nowDate && slots.length < enumerationLimit) {
+            if (cursor >= horizonCutoff) {
+                slots.push(cursor.toISOString());
+            }
+            const next = (0, cron_helpers_1.getNextRunAt)(schedule.cronExpression, schedule.timezone, cursor);
+            if (!next || next <= cursor)
+                break;
+            cursor = next;
+        }
+        return slots;
+    }
+    async claimAndExecute(schedule, plannedFor, source) {
+        const insertResult = await this.storage.createScheduledEpicRun({
+            scheduleId: schedule.id,
+            plannedFor,
+            source,
+            status: 'pending',
+        });
+        const runId = insertResult.run.id;
+        const claimResult = await this.atomicClaim(schedule, runId);
+        if (!claimResult.claimed) {
+            logger.debug({ scheduleId: schedule.id, plannedFor, runId }, 'Claim lost, deferring to next scan');
+            return;
+        }
+        await this.executeClaimedRun(claimResult.run, schedule);
+    }
+    async atomicClaim(schedule, runId) {
+        let result = await this.storage.claimScheduledEpicRun(runId);
+        if (!result.claimed && result.run.status === 'pending') {
+            result = await this.storage.claimScheduledEpicRun(runId);
+        }
+        return result;
+    }
+    async drainPendingRuns(scheduleId) {
+        const runs = await this.storage.listScheduledEpicRuns(scheduleId, {
+            status: 'pending',
+            limit: 50,
+        });
+        for (const run of runs.items) {
+            let schedule;
+            try {
+                schedule = await this.storage.getScheduledEpic(run.scheduleId);
+            }
+            catch {
+                await this.storage.updateScheduledEpicRun(run.id, {
+                    status: 'failed',
+                    finishedAt: new Date().toISOString(),
+                    errorMessage: 'Schedule not found',
+                });
+                continue;
+            }
+            const claimResult = await this.atomicClaim(schedule, run.id);
+            if (!claimResult.claimed)
+                continue;
+            await this.executeClaimedRun(claimResult.run, schedule);
+        }
+    }
+    async executeRun(run) {
+        if (run.status !== 'pending')
+            return;
+        let schedule;
+        try {
+            schedule = await this.storage.getScheduledEpic(run.scheduleId);
+        }
+        catch {
+            logger.warn({ runId: run.id, scheduleId: run.scheduleId }, 'Schedule not found for run, marking failed');
+            await this.storage.updateScheduledEpicRun(run.id, {
+                status: 'failed',
+                finishedAt: new Date().toISOString(),
+                errorMessage: 'Schedule not found',
+            });
+            return;
+        }
+        const claimResult = await this.atomicClaim(schedule, run.id);
+        if (!claimResult.claimed)
+            return;
+        await this.executeClaimedRun(claimResult.run, schedule);
+    }
+    async executeClaimedRun(run, schedule) {
+        const finishedAt = new Date().toISOString();
+        if (!schedule.enabled && run.source !== 'manual') {
+            await this.storage.updateScheduledEpicRun(run.id, {
+                status: 'skipped',
+                finishedAt,
+                errorMessage: 'Schedule disabled',
+            });
+            await this.publishRunOutcome(run, schedule, {
+                status: 'skipped',
+                finishedAt,
+                errorCode: 'SCHEDULE_DISABLED',
+                errorMessage: 'Schedule disabled',
+                createdEpicId: null,
+                createdEpicTitle: null,
+            });
+            return;
+        }
+        if (!schedule.allowOverlap) {
+            const runningRuns = await this.storage.listScheduledEpicRuns(schedule.id, {
+                status: 'running',
+                limit: 2,
+            });
+            const otherRunning = runningRuns.items.filter((r) => r.id !== run.id);
+            if (otherRunning.length > 0) {
+                logger.debug({ scheduleId: schedule.id, runId: run.id }, 'Overlap not allowed and another run is in progress, skipping');
+                await this.storage.updateScheduledEpicRun(run.id, {
+                    status: 'skipped',
+                    finishedAt,
+                    errorMessage: 'Overlap not allowed',
+                });
+                await this.publishRunOutcome(run, schedule, {
+                    status: 'skipped',
+                    finishedAt,
+                    errorCode: 'DUPLICATE_CLAIM',
+                    errorMessage: 'Overlap not allowed',
+                    createdEpicId: null,
+                    createdEpicTitle: null,
+                });
+                return;
+            }
+        }
+        let errorCode = null;
+        try {
+            const templateVars = this.buildTemplateVars(schedule, run);
+            let title;
+            let description;
+            try {
+                title = (0, template_helpers_1.renderScheduledEpicTemplate)(schedule.titleTemplate, templateVars);
+                description = schedule.descriptionTemplate
+                    ? (0, template_helpers_1.renderScheduledEpicTemplate)(schedule.descriptionTemplate, templateVars)
+                    : null;
+            }
+            catch (err) {
+                errorCode = 'TEMPLATE_RENDER_FAILED';
+                throw err;
+            }
+            const epicInput = {
+                title,
+                description,
+                tags: schedule.templateTags,
+                statusId: schedule.templateStatusId ?? undefined,
+                agentId: schedule.templateAgentId ?? undefined,
+                parentId: schedule.templateParentEpicId ?? undefined,
+            };
+            let epic;
+            try {
+                epic = await this.epicsService.createEpicForProject(schedule.projectId, epicInput);
+            }
+            catch (err) {
+                errorCode = 'EPIC_CREATE_FAILED';
+                throw err;
+            }
+            await this.storage.updateScheduledEpicRun(run.id, {
+                status: 'completed',
+                createdEpicId: epic.id,
+                finishedAt,
+            });
+            await this.storage.updateScheduledEpicRuntimeState(schedule.id, {
+                lastRunAt: finishedAt,
+                lastRunStatus: 'completed',
+                lastError: null,
+            });
+            logger.info({ scheduleId: schedule.id, runId: run.id, epicId: epic.id }, 'Scheduled epic run completed');
+            await this.publishRunOutcome(run, schedule, {
+                status: 'completed',
+                finishedAt,
+                errorCode: null,
+                errorMessage: null,
+                createdEpicId: epic.id,
+                createdEpicTitle: epic.title,
+            });
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const resolvedErrorCode = errorCode ?? 'UNKNOWN';
+            await this.storage.updateScheduledEpicRun(run.id, {
+                status: 'failed',
+                finishedAt,
+                errorMessage,
+            });
+            await this.storage.updateScheduledEpicRuntimeState(schedule.id, {
+                lastRunAt: finishedAt,
+                lastRunStatus: 'failed',
+                lastError: errorMessage,
+            });
+            logger.error({ scheduleId: schedule.id, runId: run.id, error: errorMessage }, 'Scheduled epic run failed');
+            await this.publishRunOutcome(run, schedule, {
+                status: 'failed',
+                finishedAt,
+                errorCode: resolvedErrorCode,
+                errorMessage,
+                createdEpicId: null,
+                createdEpicTitle: null,
+            });
+        }
+    }
+    async publishRunOutcome(run, schedule, outcome) {
+        const lagMs = new Date(outcome.finishedAt).getTime() - new Date(run.plannedFor).getTime();
+        try {
+            await this.eventsService.publish('scheduled_epic.executed', {
+                scheduleId: schedule.id,
+                runId: run.id,
+                projectId: schedule.projectId,
+                scheduleName: schedule.name,
+                triggerSource: run.source,
+                status: outcome.status,
+                plannedFor: run.plannedFor,
+                finishedAt: outcome.finishedAt,
+                lagMs,
+                createdEpicId: outcome.createdEpicId,
+                createdEpicTitle: outcome.createdEpicTitle,
+                errorCode: outcome.errorCode,
+                errorMessage: outcome.errorMessage,
+            });
+        }
+        catch (error) {
+            logger.warn({ error: String(error) }, 'Failed to publish scheduled_epic.executed event');
+        }
+    }
+    async recoverStaleRuns(projectId, now) {
+        const allSchedules = await this.storage.listScheduledEpics(projectId, { limit: 500 });
+        const staleCutoff = new Date(new Date(now).getTime() - STALE_RUNNING_THRESHOLD_MS).toISOString();
+        for (const schedule of allSchedules.items) {
+            const runningRuns = await this.storage.listScheduledEpicRuns(schedule.id, {
+                status: 'running',
+                limit: 50,
+            });
+            for (const run of runningRuns.items) {
+                if (run.startedAt && run.startedAt < staleCutoff) {
+                    logger.warn({ runId: run.id, scheduleId: schedule.id, startedAt: run.startedAt }, 'Recovering stale running run');
+                    await this.storage.updateScheduledEpicRun(run.id, {
+                        status: 'failed',
+                        finishedAt: now,
+                        errorMessage: 'STALE_RUNNING_RECOVERED',
+                    });
+                    await this.storage.updateScheduledEpicRuntimeState(schedule.id, {
+                        lastRunStatus: 'failed',
+                        lastError: 'STALE_RUNNING_RECOVERED',
+                    });
+                    await this.publishRunOutcome(run, schedule, {
+                        status: 'failed',
+                        finishedAt: now,
+                        errorCode: 'STALE_RUNNING_RECOVERED',
+                        errorMessage: 'STALE_RUNNING_RECOVERED',
+                        createdEpicId: null,
+                        createdEpicTitle: null,
+                    });
+                }
+            }
+        }
+    }
+    async advanceNextRunAt(schedule) {
+        const nextRunAt = (0, cron_helpers_1.getNextRunAt)(schedule.cronExpression, schedule.timezone);
+        await this.storage.updateScheduledEpicRuntimeState(schedule.id, {
+            nextRunAt: nextRunAt?.toISOString() ?? null,
+        });
+    }
+    buildTemplateVars(schedule, run) {
+        const plannedDate = new Date(run.plannedFor);
+        return {
+            schedule_name: schedule.name,
+            date: plannedDate.toISOString().split('T')[0],
+            datetime: run.plannedFor,
+            timestamp: plannedDate.getTime(),
+            run_source: run.source,
+            project_id: schedule.projectId,
+        };
+    }
+};
+exports.ScheduledEpicRunnerService = ScheduledEpicRunnerService;
+exports.ScheduledEpicRunnerService = ScheduledEpicRunnerService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(storage_interface_1.STORAGE_SERVICE)),
+    __metadata("design:paramtypes", [Object, epics_service_1.EpicsService,
+        events_service_1.EventsService])
+], ScheduledEpicRunnerService);
+//# sourceMappingURL=scheduled-epic-runner.service.js.map

package/dist/server/modules/scheduled-epics/services/scheduled-epic-runner.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-epic-runner.service.js","sourceRoot":"","sources":["../../../../src/modules/scheduled-epics/services/scheduled-epic-runner.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAmF;AACnF,kFAKoD;AAMpD,sEAAkE;AAClE,yEAAqE;AACrE,2DAA8D;AAC9D,0DAAuD;AACvD,kEAA0E;AAI1E,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,4BAA4B,CAAC,CAAC;AAE1D,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,MAAM,WAAW,GAAG,KAAK,CAAC;AAC1B,MAAM,yBAAyB,GAAG,EAAE,CAAC;AACrC,MAAM,kBAAkB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;AAChD,MAAM,0BAA0B,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC;AAG5C,IAAM,0BAA0B,GAAhC,MAAM,0BAA0B;IAMrC,YAC2B,OAAwC,EAChD,YAA0B,EAC1B,aAA4B;QAFH,YAAO,GAAP,OAAO,CAAgB;QAChD,iBAAY,GAAZ,YAAY,CAAc;QAC1B,kBAAa,GAAb,aAAa,CAAe;QANvC,cAAS,GAAyC,IAAI,CAAC;QACvD,aAAQ,GAAG,KAAK,CAAC;IAMtB,CAAC;IAEJ,YAAY;QACV,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;QACnC,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;IACpC,CAAC;IAED,eAAe;QACb,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAClC,CAAC;IAED,qBAAqB;QACnB,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IAEO,gBAAgB,CAAC,OAAe;QACtC,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAC1D,CAAC;IAEO,cAAc;QACpB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC7B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACxB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,IAAI;QAChB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;QAC9B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC;QAC9D,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC;YACtB,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,cAAc;QAC1B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAEjE,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YACrC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACrC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CACV,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAC/C,kCAAkC,CACnC,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,SAAiB;QACzC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAErC,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAE5C,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QAE9E,KAAK,MAAM,QAAQ,IAAI,YAAY,EAAE,CAAC;YACpC,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CACV,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EACjD,4BAA4B,CAC7B,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACtF,KAAK,MAAM,QAAQ,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;YAC1C,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC3C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,KAAK,CACV,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EACjD,8BAA8B,CAC/B,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,QAAuB,EAAE,GAAW;QAChE,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS;YAAE,OAAO;QAErD,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QAE3D,IAAI,WAAW,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;YACtE,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QAED,QAAQ,QAAQ,CAAC,eAAe,EAAE,CAAC;YACjC,KAAK,MAAM;gBACT,MAAM,CAAC,IAAI,CACT,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,EACvD,iCAAiC,CAClC,CAAC;gBACF,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;gBACtC,MAAM;YAER,KAAK,UAAU;gBACb,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,WAAW,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,CAAE,EAAE,WAAW,CAAC,CAAC;gBACxF,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;gBACtC,MAAM;YAER,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,cAAc,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,yBAAyB,CAAC,CAAC;gBACvE,KAAK,MAAM,IAAI,IAAI,cAAc,EAAE,CAAC;oBAClC,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;gBAC1D,CAAC;gBACD,IAAI,WAAW,CAAC,MAAM,GAAG,yBAAyB,EAAE,CAAC;oBACnD,MAAM,gBAAgB,GAAG,WAAW,CAAC,yBAAyB,CAAE,CAAC;oBACjE,MAAM,IAAI,CAAC,OAAO,CAAC,+BAA+B,CAAC,QAAQ,CAAC,EAAE,EAAE;wBAC9D,SAAS,EAAE,gBAAgB;qBAC5B,CAAC,CAAC;oBACH,MAAM,CAAC,IAAI,CACT;wBACE,UAAU,EAAE,QAAQ,CAAC,EAAE;wBACvB,SAAS,EAAE,cAAc,CAAC,MAAM;wBAChC,SAAS,EAAE,WAAW,CAAC,MAAM,GAAG,yBAAyB;wBACzD,SAAS,EAAE,gBAAgB;qBAC5B,EACD,mDAAmD,CACpD,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;gBACxC,CAAC;gBACD,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAEO,kBAAkB,CAAC,QAAuB,EAAE,GAAW;QAC7D,IAAI,CAAC,QAAQ,CAAC,SAAS;YAAE,OAAO,EAAE,CAAC;QAEnC,MAAM,KAAK,GAAa,EAAE,CAAC;QAC3B,IAAI,MAAM,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,aAAa,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,kBAAkB,CAAC,CAAC;QACvE,MAAM,gBAAgB,GAAG,yBAAyB,GAAG,EAAE,CAAC;QAExD,OAAO,MAAM,IAAI,OAAO,IAAI,KAAK,CAAC,MAAM,GAAG,gBAAgB,EAAE,CAAC;YAC5D,IAAI,MAAM,IAAI,aAAa,EAAE,CAAC;gBAC5B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;YACnC,CAAC;YACD,MAAM,IAAI,GAAG,IAAA,2BAAY,EAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC9E,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,MAAM;gBAAE,MAAM;YACnC,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEO,KAAK,CAAC,eAAe,CAC3B,QAAuB,EACvB,UAAkB,EAClB,MAA8B;QAE9B,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC;YAC7D,UAAU,EAAE,QAAQ,CAAC,EAAE;YACvB,UAAU;YACV,MAAM;YACN,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;QAEH,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAE5D,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,CAAC,KAAK,CACV,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,EAC9C,oCAAoC,CACrC,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAEO,KAAK,CAAC,WAAW,CAAC,QAAuB,EAAE,KAAa;QAC9D,IAAI,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAE7D,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YACvD,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC;QAC3D,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,UAAkB;QAC/C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,UAAU,EAAE;YAChE,MAAM,EAAE,SAAS;YACjB,KAAK,EAAE,EAAE;SACV,CAAC,CAAC;QAEH,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YAC7B,IAAI,QAAuB,CAAC;YAC5B,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACjE,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,EAAE,EAAE;oBAChD,MAAM,EAAE,QAAQ;oBAChB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;oBACpC,YAAY,EAAE,oBAAoB;iBACnC,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YAC7D,IAAI,CAAC,WAAW,CAAC,OAAO;gBAAE,SAAS;YACnC,MAAM,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,GAAqB;QACpC,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO;QAErC,IAAI,QAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACjE,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,IAAI,CACT,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,EAC7C,4CAA4C,CAC7C,CAAC;YACF,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,EAAE,EAAE;gBAChD,MAAM,EAAE,QAAQ;gBAChB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACpC,YAAY,EAAE,oBAAoB;aACnC,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,WAAW,CAAC,OAAO;YAAE,OAAO;QAEjC,MAAM,IAAI,CAAC,iBAAiB,CAAC,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,GAAqB,EAAE,QAAuB;QAC5E,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAE5C,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YACjD,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,EAAE,EAAE;gBAChD,MAAM,EAAE,SAAS;gBACjB,UAAU;gBACV,YAAY,EAAE,mBAAmB;aAClC,CAAC,CAAC;YACH,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,QAAQ,EAAE;gBAC1C,MAAM,EAAE,SAAS;gBACjB,UAAU;gBACV,SAAS,EAAE,mBAAmB;gBAC9B,YAAY,EAAE,mBAAmB;gBACjC,aAAa,EAAE,IAAI;gBACnB,gBAAgB,EAAE,IAAI;aACvB,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;YAC3B,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,EAAE;gBACxE,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,CAAC;aACT,CAAC,CAAC;YACH,MAAM,YAAY,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;YACtE,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,CAAC,KAAK,CACV,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,EAC1C,8DAA8D,CAC/D,CAAC;gBACF,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,EAAE,EAAE;oBAChD,MAAM,EAAE,SAAS;oBACjB,UAAU;oBACV,YAAY,EAAE,qBAAqB;iBACpC,CAAC,CAAC;gBACH,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,QAAQ,EAAE;oBAC1C,MAAM,EAAE,SAAS;oBACjB,UAAU;oBACV,SAAS,EAAE,iBAAiB;oBAC5B,YAAY,EAAE,qBAAqB;oBACnC,aAAa,EAAE,IAAI;oBACnB,gBAAgB,EAAE,IAAI;iBACvB,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;QACH,CAAC;QAED,IAAI,SAAS,GAAkC,IAAI,CAAC;QAEpD,IAAI,CAAC;YACH,MAAM,YAAY,GAAG,IAAI,CAAC,iBAAiB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAC3D,IAAI,KAAa,CAAC;YAClB,IAAI,WAA0B,CAAC;YAE/B,IAAI,CAAC;gBACH,KAAK,GAAG,IAAA,8CAA2B,EAAC,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;gBAC1E,WAAW,GAAG,QAAQ,CAAC,mBAAmB;oBACxC,CAAC,CAAC,IAAA,8CAA2B,EAAC,QAAQ,CAAC,mBAAmB,EAAE,YAAY,CAAC;oBACzE,CAAC,CAAC,IAAI,CAAC;YACX,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,GAAG,wBAAwB,CAAC;gBACrC,MAAM,GAAG,CAAC;YACZ,CAAC;YAED,MAAM,SAAS,GAA8B;gBAC3C,KAAK;gBACL,WAAW;gBACX,IAAI,EAAE,QAAQ,CAAC,YAAY;gBAC3B,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,IAAI,SAAS;gBAChD,OAAO,EAAE,QAAQ,CAAC,eAAe,IAAI,SAAS;gBAC9C,QAAQ,EAAE,QAAQ,CAAC,oBAAoB,IAAI,SAAS;aACrD,CAAC;YAEF,IAAI,IAAwE,CAAC;YAC7E,IAAI,CAAC;gBACH,IAAI,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,oBAAoB,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YACrF,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,GAAG,oBAAoB,CAAC;gBACjC,MAAM,GAAG,CAAC;YACZ,CAAC;YAED,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,EAAE,EAAE;gBAChD,MAAM,EAAE,WAAW;gBACnB,aAAa,EAAE,IAAI,CAAC,EAAE;gBACtB,UAAU;aACX,CAAC,CAAC;YAEH,MAAM,IAAI,CAAC,OAAO,CAAC,+BAA+B,CAAC,QAAQ,CAAC,EAAE,EAAE;gBAC9D,SAAS,EAAE,UAAU;gBACrB,aAAa,EAAE,WAAW;gBAC1B,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;YAEH,MAAM,CAAC,IAAI,CACT,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,EAC3D,8BAA8B,CAC/B,CAAC;YAEF,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,QAAQ,EAAE;gBAC1C,MAAM,EAAE,WAAW;gBACnB,UAAU;gBACV,SAAS,EAAE,IAAI;gBACf,YAAY,EAAE,IAAI;gBAClB,aAAa,EAAE,IAAI,CAAC,EAAE;gBACtB,gBAAgB,EAAE,IAAI,CAAC,KAAK;aAC7B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,MAAM,iBAAiB,GAA2B,SAAS,IAAI,SAAS,CAAC;YAEzE,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,EAAE,EAAE;gBAChD,MAAM,EAAE,QAAQ;gBAChB,UAAU;gBACV,YAAY;aACb,CAAC,CAAC;YAEH,MAAM,IAAI,CAAC,OAAO,CAAC,+BAA+B,CAAC,QAAQ,CAAC,EAAE,EAAE;gBAC9D,SAAS,EAAE,UAAU;gBACrB,aAAa,EAAE,QAAQ;gBACvB,SAAS,EAAE,YAAY;aACxB,CAAC,CAAC;YAEH,MAAM,CAAC,KAAK,CACV,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,EAC/D,2BAA2B,CAC5B,CAAC;YAEF,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,QAAQ,EAAE;gBAC1C,MAAM,EAAE,QAAQ;gBAChB,UAAU;gBACV,SAAS,EAAE,iBAAiB;gBAC5B,YAAY;gBACZ,aAAa,EAAE,IAAI;gBACnB,gBAAgB,EAAE,IAAI;aACvB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,GAAqB,EACrB,QAAuB,EACvB,OAOC;QAED,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,CAAC;QAC1F,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,yBAAyB,EAAE;gBAC1D,UAAU,EAAE,QAAQ,CAAC,EAAE;gBACvB,KAAK,EAAE,GAAG,CAAC,EAAE;gBACb,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,YAAY,EAAE,QAAQ,CAAC,IAAI;gBAC3B,aAAa,EAAE,GAAG,CAAC,MAAM;gBACzB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,KAAK;gBACL,aAAa,EAAE,OAAO,CAAC,aAAa;gBACpC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;gBAC1C,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,iDAAiD,CAAC,CAAC;QAC3F,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,SAAiB,EAAE,GAAW;QAC3D,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QACtF,MAAM,WAAW,GAAG,IAAI,IAAI,CAC1B,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,0BAA0B,CACrD,CAAC,WAAW,EAAE,CAAC;QAEhB,KAAK,MAAM,QAAQ,IAAI,YAAY,CAAC,KAAK,EAAE,CAAC;YAC1C,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,QAAQ,CAAC,EAAE,EAAE;gBACxE,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,EAAE;aACV,CAAC,CAAC;YAEH,KAAK,MAAM,GAAG,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;gBACpC,IAAI,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,SAAS,GAAG,WAAW,EAAE,CAAC;oBACjD,MAAM,CAAC,IAAI,CACT,EAAE,KAAK,EAAE,GAAG,CAAC,EAAE,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,EACpE,8BAA8B,CAC/B,CAAC;oBACF,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,EAAE,EAAE;wBAChD,MAAM,EAAE,QAAQ;wBAChB,UAAU,EAAE,GAAG;wBACf,YAAY,EAAE,yBAAyB;qBACxC,CAAC,CAAC;oBACH,MAAM,IAAI,CAAC,OAAO,CAAC,+BAA+B,CAAC,QAAQ,CAAC,EAAE,EAAE;wBAC9D,aAAa,EAAE,QAAQ;wBACvB,SAAS,EAAE,yBAAyB;qBACrC,CAAC,CAAC;oBACH,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,QAAQ,EAAE;wBAC1C,MAAM,EAAE,QAAQ;wBAChB,UAAU,EAAE,GAAG;wBACf,SAAS,EAAE,yBAAyB;wBACpC,YAAY,EAAE,yBAAyB;wBACvC,aAAa,EAAE,IAAI;wBACnB,gBAAgB,EAAE,IAAI;qBACvB,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAAC,QAAuB;QACpD,MAAM,SAAS,GAAG,IAAA,2BAAY,EAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC3E,MAAM,IAAI,CAAC,OAAO,CAAC,+BAA+B,CAAC,QAAQ,CAAC,EAAE,EAAE;YAC9D,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,IAAI;SAC5C,CAAC,CAAC;IACL,CAAC;IAEO,iBAAiB,CACvB,QAAuB,EACvB,GAAqB;QAErB,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7C,OAAO;YACL,aAAa,EAAE,QAAQ,CAAC,IAAI;YAC5B,IAAI,EAAE,WAAW,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC7C,QAAQ,EAAE,GAAG,CAAC,UAAU;YACxB,SAAS,EAAE,WAAW,CAAC,OAAO,EAAE;YAChC,UAAU,EAAE,GAAG,CAAC,MAAM;YACtB,UAAU,EAAE,QAAQ,CAAC,SAAS;SAC/B,CAAC;IACJ,CAAC;CACF,CAAA;AA/eY,gEAA0B;qCAA1B,0BAA0B;IADtC,IAAA,mBAAU,GAAE;IAQR,WAAA,IAAA,eAAM,EAAC,mCAAe,CAAC,CAAA;6CACO,4BAAY;QACX,8BAAa;GATpC,0BAA0B,CA+etC"}

package/dist/server/modules/scheduled-epics/services/scheduled-epics.service.d.ts

@@ -0,0 +1,23 @@
+import { type ScheduledEpicStorage, type ListScheduledEpicsOptions, type ListScheduledEpicRunsOptions, type ListResult } from '../../storage/interfaces/storage.interface';
+import type { ScheduledEpic, ScheduledEpicRun } from '../../storage/models/domain.models';
+import type { ClaimRunResult } from '../../storage/interfaces/storage.interface';
+import { type CreateScheduledEpicDto, type UpdateScheduledEpicDto } from '../dtos/scheduled-epic.dto';
+export declare const SCHEDULED_EPIC_RUNNER_REFRESH = "SCHEDULED_EPIC_RUNNER_REFRESH";
+export interface ScheduledEpicRunnerRefresh {
+    refreshScheduleWindow(): void;
+}
+export declare class ScheduledEpicsService {
+    private readonly storage;
+    private readonly runnerRefresh?;
+    constructor(storage: ScheduledEpicStorage, runnerRefresh?: ScheduledEpicRunnerRefresh | undefined);
+    create(dto: CreateScheduledEpicDto): Promise<ScheduledEpic>;
+    get(id: string): Promise<ScheduledEpic>;
+    list(projectId: string, options?: ListScheduledEpicsOptions): Promise<ListResult<ScheduledEpic>>;
+    update(id: string, dto: UpdateScheduledEpicDto, configVersion: number): Promise<ScheduledEpic>;
+    delete(id: string): Promise<void>;
+    toggle(id: string, enabled: boolean, configVersion: number): Promise<ScheduledEpic>;
+    runNow(id: string): Promise<ClaimRunResult>;
+    listRuns(scheduleId: string, options?: ListScheduledEpicRunsOptions): Promise<ListResult<ScheduledEpicRun>>;
+    private computeNextRunAt;
+    private notifyRunner;
+}

package/dist/server/modules/scheduled-epics/services/scheduled-epics.service.js

@@ -0,0 +1,136 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ScheduledEpicsService = exports.SCHEDULED_EPIC_RUNNER_REFRESH = void 0;
+const common_1 = require("@nestjs/common");
+const storage_interface_1 = require("../../storage/interfaces/storage.interface");
+const error_types_1 = require("../../../common/errors/error-types");
+const logger_1 = require("../../../common/logging/logger");
+const cron_helpers_1 = require("../helpers/cron-helpers");
+const scheduled_epic_dto_1 = require("../dtos/scheduled-epic.dto");
+exports.SCHEDULED_EPIC_RUNNER_REFRESH = 'SCHEDULED_EPIC_RUNNER_REFRESH';
+const logger = (0, logger_1.createLogger)('ScheduledEpicsService');
+let ScheduledEpicsService = class ScheduledEpicsService {
+    constructor(storage, runnerRefresh) {
+        this.storage = storage;
+        this.runnerRefresh = runnerRefresh;
+    }
+    async create(dto) {
+        const parsed = scheduled_epic_dto_1.CreateScheduledEpicDtoSchema.parse(dto);
+        const nextRunAt = this.computeNextRunAt(parsed.cronExpression, parsed.timezone);
+        const schedule = await this.storage.createScheduledEpic({
+            projectId: parsed.projectId,
+            name: parsed.name,
+            cronExpression: parsed.cronExpression,
+            timezone: parsed.timezone,
+            enabled: parsed.enabled,
+            titleTemplate: parsed.titleTemplate,
+            descriptionTemplate: parsed.descriptionTemplate ?? null,
+            templateStatusId: parsed.templateStatusId ?? null,
+            templateParentEpicId: parsed.templateParentEpicId ?? null,
+            templateAgentId: parsed.templateAgentId ?? null,
+            templateTags: parsed.templateTags,
+            allowOverlap: parsed.allowOverlap,
+            missedRunPolicy: parsed.missedRunPolicy,
+            nextRunAt: nextRunAt?.toISOString() ?? null,
+        });
+        logger.info({ scheduleId: schedule.id, name: schedule.name }, 'Scheduled epic created');
+        this.notifyRunner();
+        return schedule;
+    }
+    async get(id) {
+        return this.storage.getScheduledEpic(id);
+    }
+    async list(projectId, options) {
+        return this.storage.listScheduledEpics(projectId, options);
+    }
+    async update(id, dto, configVersion) {
+        const parsed = scheduled_epic_dto_1.UpdateScheduledEpicDtoSchema.parse(dto);
+        if (Object.keys(parsed).length === 0) {
+            throw new error_types_1.ValidationError('At least one field must be provided for update');
+        }
+        const current = await this.storage.getScheduledEpic(id);
+        const configUpdate = { ...parsed };
+        let schedule = await this.storage.updateScheduledEpic(id, configUpdate, configVersion);
+        const cronOrTzChanged = parsed.cronExpression !== undefined || parsed.timezone !== undefined;
+        if (cronOrTzChanged) {
+            const cronExpression = parsed.cronExpression ?? current.cronExpression;
+            const timezone = parsed.timezone ?? current.timezone;
+            const nextRunAt = this.computeNextRunAt(cronExpression, timezone);
+            schedule = await this.storage.updateScheduledEpicRuntimeState(id, {
+                nextRunAt: nextRunAt?.toISOString() ?? null,
+            });
+        }
+        logger.info({ scheduleId: id }, 'Scheduled epic updated');
+        this.notifyRunner();
+        return schedule;
+    }
+    async delete(id) {
+        await this.storage.getScheduledEpic(id);
+        await this.storage.deleteScheduledEpic(id);
+        logger.info({ scheduleId: id }, 'Scheduled epic deleted');
+        this.notifyRunner();
+    }
+    async toggle(id, enabled, configVersion) {
+        let schedule = await this.storage.updateScheduledEpic(id, { enabled }, configVersion);
+        if (enabled && !schedule.nextRunAt) {
+            const nextRunAt = this.computeNextRunAt(schedule.cronExpression, schedule.timezone);
+            schedule = await this.storage.updateScheduledEpicRuntimeState(id, {
+                nextRunAt: nextRunAt?.toISOString() ?? null,
+            });
+        }
+        logger.info({ scheduleId: id, enabled }, 'Scheduled epic toggled');
+        this.notifyRunner();
+        return schedule;
+    }
+    async runNow(id) {
+        await this.storage.getScheduledEpic(id);
+        const plannedFor = new Date().toISOString();
+        const result = await this.storage.createScheduledEpicRun({
+            scheduleId: id,
+            plannedFor,
+            source: 'manual',
+            status: 'pending',
+        });
+        logger.info({ scheduleId: id, runId: result.run.id, claimed: result.claimed }, 'Manual run requested');
+        this.notifyRunner();
+        return result;
+    }
+    async listRuns(scheduleId, options) {
+        await this.storage.getScheduledEpic(scheduleId);
+        return this.storage.listScheduledEpicRuns(scheduleId, options);
+    }
+    computeNextRunAt(cronExpression, timezone) {
+        return (0, cron_helpers_1.getNextRunAt)(cronExpression, timezone);
+    }
+    notifyRunner() {
+        if (this.runnerRefresh) {
+            try {
+                this.runnerRefresh.refreshScheduleWindow();
+            }
+            catch (error) {
+                logger.warn({ error: String(error) }, 'Failed to notify runner of schedule change');
+            }
+        }
+    }
+};
+exports.ScheduledEpicsService = ScheduledEpicsService;
+exports.ScheduledEpicsService = ScheduledEpicsService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(storage_interface_1.STORAGE_SERVICE)),
+    __param(1, (0, common_1.Optional)()),
+    __param(1, (0, common_1.Inject)(exports.SCHEDULED_EPIC_RUNNER_REFRESH)),
+    __metadata("design:paramtypes", [Object, Object])
+], ScheduledEpicsService);
+//# sourceMappingURL=scheduled-epics.service.js.map

package/dist/server/modules/scheduled-epics/services/scheduled-epics.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduled-epics.service.js","sourceRoot":"","sources":["../../../../src/modules/scheduled-epics/services/scheduled-epics.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA8D;AAC9D,kFAMoD;AAOpD,oEAAqE;AACrE,2DAA8D;AAC9D,0DAAuD;AACvD,mEAKoC;AAEvB,QAAA,6BAA6B,GAAG,+BAA+B,CAAC;AAM7E,MAAM,MAAM,GAAG,IAAA,qBAAY,EAAC,uBAAuB,CAAC,CAAC;AAG9C,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,YAC4C,OAA6B,EAGtD,aAA0C;QAHjB,YAAO,GAAP,OAAO,CAAsB;QAGtD,kBAAa,GAAb,aAAa,CAA6B;IAC1D,CAAC;IAEJ,KAAK,CAAC,MAAM,CAAC,GAA2B;QACtC,MAAM,MAAM,GAAG,iDAA4B,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEvD,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAEhF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC;YACtD,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,mBAAmB,EAAE,MAAM,CAAC,mBAAmB,IAAI,IAAI;YACvD,gBAAgB,EAAE,MAAM,CAAC,gBAAgB,IAAI,IAAI;YACjD,oBAAoB,EAAE,MAAM,CAAC,oBAAoB,IAAI,IAAI;YACzD,eAAe,EAAE,MAAM,CAAC,eAAe,IAAI,IAAI;YAC/C,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,IAAI;SAC5C,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,wBAAwB,CAAC,CAAC;QACxF,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,KAAK,CAAC,IAAI,CACR,SAAiB,EACjB,OAAmC;QAEnC,OAAO,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAC7D,CAAC;IAED,KAAK,CAAC,MAAM,CACV,EAAU,EACV,GAA2B,EAC3B,aAAqB;QAErB,MAAM,MAAM,GAAG,iDAA4B,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAEvD,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,6BAAe,CAAC,gDAAgD,CAAC,CAAC;QAC9E,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAExD,MAAM,YAAY,GAAwB,EAAE,GAAG,MAAM,EAAE,CAAC;QACxD,IAAI,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;QAEvF,MAAM,eAAe,GAAG,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC;QAE7F,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,CAAC;YACvE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC;YACrD,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;YAClE,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,+BAA+B,CAAC,EAAE,EAAE;gBAChE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,IAAI;aAC5C,CAAC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,wBAAwB,CAAC,CAAC;QAC1D,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC,CAAC;QAE3C,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,EAAE,wBAAwB,CAAC,CAAC;QAC1D,IAAI,CAAC,YAAY,EAAE,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,OAAgB,EAAE,aAAqB;QAC9D,IAAI,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,aAAa,CAAC,CAAC;QAEtF,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;YACpF,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,+BAA+B,CAAC,EAAE,EAAE;gBAChE,SAAS,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,IAAI;aAC5C,CAAC,CAAC;QACL,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,wBAAwB,CAAC,CAAC;QACnE,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;QAExC,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,sBAAsB,CAAC;YACvD,UAAU,EAAE,EAAE;YACd,UAAU;YACV,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,SAAS;SAClB,CAAC,CAAC;QAEH,MAAM,CAAC,IAAI,CACT,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,EACjE,sBAAsB,CACvB,CAAC;QACF,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,UAAkB,EAClB,OAAsC;QAEtC,MAAM,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAEO,gBAAgB,CAAC,cAAsB,EAAE,QAAgB;QAC/D,OAAO,IAAA,2BAAY,EAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;IAEO,YAAY;QAClB,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,IAAI,CAAC;gBACH,IAAI,CAAC,aAAa,CAAC,qBAAqB,EAAE,CAAC;YAC7C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,4CAA4C,CAAC,CAAC;YACtF,CAAC;QACH,CAAC;IACH,CAAC;CACF,CAAA;AA7IY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,eAAM,EAAC,mCAAe,CAAC,CAAA;IACvB,WAAA,IAAA,iBAAQ,GAAE,CAAA;IACV,WAAA,IAAA,eAAM,EAAC,qCAA6B,CAAC,CAAA;;GAJ7B,qBAAqB,CA6IjC"}