specweave 0.28.67 → 0.29.0

package/dist/src/core/scheduler/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Scheduler Module
+ *
+ * Exports job scheduling functionality for the sync orchestration system.
+ *
+ * @module core/scheduler
+ */
+export * from './scheduled-job.js';
+export * from './job-scheduler.js';
+export * from './schedule-persistence.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/core/scheduler/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/core/scheduler/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC"}

package/dist/src/core/scheduler/index.js

@@ -0,0 +1,11 @@
+/**
+ * Scheduler Module
+ *
+ * Exports job scheduling functionality for the sync orchestration system.
+ *
+ * @module core/scheduler
+ */
+export * from './scheduled-job.js';
+export * from './job-scheduler.js';
+export * from './schedule-persistence.js';
+//# sourceMappingURL=index.js.map

package/dist/src/core/scheduler/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/scheduler/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,2BAA2B,CAAC"}

package/dist/src/core/scheduler/job-scheduler.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Job Scheduler
+ *
+ * Core scheduler that manages recurring jobs with configurable intervals.
+ * Supports pause/resume, retry with backoff, and job state tracking.
+ *
+ * @module core/scheduler/job-scheduler
+ */
+import { ScheduledJob, ScheduledJobConfig, JobType } from './scheduled-job.js';
+import { Logger } from '../../utils/logger.js';
+/**
+ * Job scheduler configuration
+ */
+export interface JobSchedulerOptions {
+    /**
+     * Logger instance
+     */
+    logger?: Logger;
+}
+/**
+ * Job scheduler events
+ */
+export type JobSchedulerEvent = 'job-registered' | 'job-unregistered' | 'job-started' | 'job-completed' | 'job-failed' | 'job-paused' | 'job-resumed';
+/**
+ * Event listener callback
+ */
+export type JobSchedulerEventListener = (event: JobSchedulerEvent, job: ScheduledJob, data?: Record<string, unknown>) => void;
+/**
+ * JobScheduler - Manages recurring background jobs
+ *
+ * Key features:
+ * - Register/unregister jobs dynamically
+ * - Check for due jobs (for execution by caller)
+ * - Track job state (idle, running, failed, disabled)
+ * - Exponential backoff for failed jobs
+ * - Event notifications for state changes
+ */
+export declare class JobScheduler {
+    private jobs;
+    private listeners;
+    private readonly logger;
+    constructor(options?: JobSchedulerOptions);
+    /**
+     * Register a new job with the scheduler
+     *
+     * @param config - Job configuration
+     * @throws Error if job with same ID already exists
+     */
+    registerJob(config: ScheduledJobConfig): void;
+    /**
+     * Unregister a job from the scheduler
+     *
+     * @param jobId - Job ID to remove
+     * @returns true if job was removed, false if not found
+     */
+    unregisterJob(jobId: string): boolean;
+    /**
+     * Get a job by ID
+     *
+     * @param jobId - Job ID
+     * @returns Job or undefined if not found
+     */
+    getJob(jobId: string): ScheduledJob | undefined;
+    /**
+     * Get all registered jobs
+     *
+     * @returns Array of all jobs
+     */
+    getAllJobs(): ScheduledJob[];
+    /**
+     * Get jobs by type
+     *
+     * @param type - Job type to filter by
+     * @returns Array of matching jobs
+     */
+    getJobsByType(type: JobType): ScheduledJob[];
+    /**
+     * Get all jobs that are due for execution
+     *
+     * @returns Array of due jobs (sorted by next run time)
+     */
+    getNextDueJobs(): ScheduledJob[];
+    /**
+     * Mark a job as started (running)
+     *
+     * @param jobId - Job ID
+     * @throws Error if job not found or not in idle state
+     */
+    markJobStarted(jobId: string): void;
+    /**
+     * Mark a job as completed successfully
+     *
+     * @param jobId - Job ID
+     * @param data - Optional result data
+     * @throws Error if job not found
+     */
+    markJobComplete(jobId: string, data?: Record<string, unknown>): void;
+    /**
+     * Mark a job as failed
+     *
+     * @param jobId - Job ID
+     * @param error - Error message
+     * @throws Error if job not found
+     */
+    markJobFailed(jobId: string, error: string): void;
+    /**
+     * Pause a job (stops scheduling but preserves state)
+     *
+     * @param jobId - Job ID
+     * @throws Error if job not found
+     */
+    pauseJob(jobId: string): void;
+    /**
+     * Resume a paused job
+     *
+     * @param jobId - Job ID
+     * @throws Error if job not found
+     */
+    resumeJob(jobId: string): void;
+    /**
+     * Reset a failed job for retry
+     *
+     * @param jobId - Job ID
+     * @throws Error if job not found
+     */
+    resetJob(jobId: string): void;
+    /**
+     * Update job interval
+     *
+     * @param jobId - Job ID
+     * @param intervalMs - New interval in milliseconds
+     * @throws Error if job not found
+     */
+    updateJobInterval(jobId: string, intervalMs: number): void;
+    /**
+     * Load jobs from persisted state
+     *
+     * @param jobs - Array of persisted jobs
+     */
+    loadJobs(jobs: ScheduledJob[]): void;
+    /**
+     * Get all jobs for persistence
+     *
+     * @returns Array of all jobs
+     */
+    getJobsForPersistence(): ScheduledJob[];
+    /**
+     * Add an event listener
+     *
+     * @param listener - Callback function
+     */
+    addEventListener(listener: JobSchedulerEventListener): void;
+    /**
+     * Remove an event listener
+     *
+     * @param listener - Callback function
+     */
+    removeEventListener(listener: JobSchedulerEventListener): void;
+    /**
+     * Get scheduler statistics
+     *
+     * @returns Scheduler stats
+     */
+    getStats(): {
+        totalJobs: number;
+        byStatus: Record<string, number>;
+        byType: Record<string, number>;
+        dueCount: number;
+    };
+    /**
+     * Emit an event to all listeners
+     */
+    private emit;
+    /**
+     * Get a job or throw if not found
+     */
+    private getJobOrThrow;
+}
+//# sourceMappingURL=job-scheduler.d.ts.map

package/dist/src/core/scheduler/job-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-scheduler.d.ts","sourceRoot":"","sources":["../../../../src/core/scheduler/job-scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,OAAO,EASR,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,kBAAkB,GAClB,aAAa,GACb,eAAe,GACf,YAAY,GACZ,YAAY,GACZ,aAAa,CAAC;AAElB;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,CACtC,KAAK,EAAE,iBAAiB,EACxB,GAAG,EAAE,YAAY,EACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC3B,IAAI,CAAC;AAEV;;;;;;;;;GASG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,SAAS,CAAiC;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,GAAE,mBAAwB;IAM7C;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI;IAY7C;;;;;OAKG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAYrC;;;;;OAKG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAI/C;;;;OAIG;IACH,UAAU,IAAI,YAAY,EAAE;IAI5B;;;;;OAKG;IACH,aAAa,CAAC,IAAI,EAAE,OAAO,GAAG,YAAY,EAAE;IAI5C;;;;OAIG;IACH,cAAc,IAAI,YAAY,EAAE;IAWhC;;;;;OAKG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAcnC;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAUpE;;;;;;OAMG;IACH,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAcjD;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAU7B;;;;;OAKG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAU9B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAS7B;;;;;;OAMG;IACH,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAe1D;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,IAAI;IAQpC;;;;OAIG;IACH,qBAAqB,IAAI,YAAY,EAAE;IAIvC;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI;IAI3D;;;;OAIG;IACH,mBAAmB,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI;IAI9D;;;;OAIG;IACH,QAAQ,IAAI;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,QAAQ,EAAE,MAAM,CAAC;KAClB;IAkBD;;OAEG;IACH,OAAO,CAAC,IAAI;IAcZ;;OAEG;IACH,OAAO,CAAC,aAAa;CAOtB"}

package/dist/src/core/scheduler/job-scheduler.js

@@ -0,0 +1,282 @@
+/**
+ * Job Scheduler
+ *
+ * Core scheduler that manages recurring jobs with configurable intervals.
+ * Supports pause/resume, retry with backoff, and job state tracking.
+ *
+ * @module core/scheduler/job-scheduler
+ */
+import { createScheduledJob, isJobDue, markJobComplete, markJobFailed, markJobRunning, pauseJob, resumeJob, resetJob, } from './scheduled-job.js';
+import { consoleLogger } from '../../utils/logger.js';
+/**
+ * JobScheduler - Manages recurring background jobs
+ *
+ * Key features:
+ * - Register/unregister jobs dynamically
+ * - Check for due jobs (for execution by caller)
+ * - Track job state (idle, running, failed, disabled)
+ * - Exponential backoff for failed jobs
+ * - Event notifications for state changes
+ */
+export class JobScheduler {
+    constructor(options = {}) {
+        this.jobs = new Map();
+        this.listeners = new Set();
+        this.logger = options.logger ?? consoleLogger;
+    }
+    /**
+     * Register a new job with the scheduler
+     *
+     * @param config - Job configuration
+     * @throws Error if job with same ID already exists
+     */
+    registerJob(config) {
+        if (this.jobs.has(config.id)) {
+            throw new Error(`Job with ID "${config.id}" already registered`);
+        }
+        const job = createScheduledJob(config);
+        this.jobs.set(config.id, job);
+        this.logger.debug(`Registered job: ${config.id} (interval: ${config.intervalMs}ms)`);
+        this.emit('job-registered', job);
+    }
+    /**
+     * Unregister a job from the scheduler
+     *
+     * @param jobId - Job ID to remove
+     * @returns true if job was removed, false if not found
+     */
+    unregisterJob(jobId) {
+        const job = this.jobs.get(jobId);
+        if (!job) {
+            return false;
+        }
+        this.jobs.delete(jobId);
+        this.logger.debug(`Unregistered job: ${jobId}`);
+        this.emit('job-unregistered', job);
+        return true;
+    }
+    /**
+     * Get a job by ID
+     *
+     * @param jobId - Job ID
+     * @returns Job or undefined if not found
+     */
+    getJob(jobId) {
+        return this.jobs.get(jobId);
+    }
+    /**
+     * Get all registered jobs
+     *
+     * @returns Array of all jobs
+     */
+    getAllJobs() {
+        return Array.from(this.jobs.values());
+    }
+    /**
+     * Get jobs by type
+     *
+     * @param type - Job type to filter by
+     * @returns Array of matching jobs
+     */
+    getJobsByType(type) {
+        return this.getAllJobs().filter((job) => job.type === type);
+    }
+    /**
+     * Get all jobs that are due for execution
+     *
+     * @returns Array of due jobs (sorted by next run time)
+     */
+    getNextDueJobs() {
+        const dueJobs = this.getAllJobs().filter(isJobDue);
+        // Sort by next run time (earliest first)
+        return dueJobs.sort((a, b) => {
+            const aTime = a.schedule.nextRun ? new Date(a.schedule.nextRun).getTime() : 0;
+            const bTime = b.schedule.nextRun ? new Date(b.schedule.nextRun).getTime() : 0;
+            return aTime - bTime;
+        });
+    }
+    /**
+     * Mark a job as started (running)
+     *
+     * @param jobId - Job ID
+     * @throws Error if job not found or not in idle state
+     */
+    markJobStarted(jobId) {
+        const job = this.getJobOrThrow(jobId);
+        if (job.status !== 'idle') {
+            throw new Error(`Cannot start job "${jobId}" - status is "${job.status}", expected "idle"`);
+        }
+        const updatedJob = markJobRunning(job);
+        this.jobs.set(jobId, updatedJob);
+        this.logger.debug(`Job started: ${jobId}`);
+        this.emit('job-started', updatedJob);
+    }
+    /**
+     * Mark a job as completed successfully
+     *
+     * @param jobId - Job ID
+     * @param data - Optional result data
+     * @throws Error if job not found
+     */
+    markJobComplete(jobId, data) {
+        const job = this.getJobOrThrow(jobId);
+        const updatedJob = markJobComplete(job);
+        this.jobs.set(jobId, updatedJob);
+        this.logger.debug(`Job completed: ${jobId}, next run: ${updatedJob.schedule.nextRun}`);
+        this.emit('job-completed', updatedJob, data);
+    }
+    /**
+     * Mark a job as failed
+     *
+     * @param jobId - Job ID
+     * @param error - Error message
+     * @throws Error if job not found
+     */
+    markJobFailed(jobId, error) {
+        const job = this.getJobOrThrow(jobId);
+        const updatedJob = markJobFailed(job, error);
+        this.jobs.set(jobId, updatedJob);
+        const retryInfo = updatedJob.status === 'failed'
+            ? 'max retries reached'
+            : `retry ${updatedJob.schedule.retryCount}/${updatedJob.schedule.maxRetries}`;
+        this.logger.warn(`Job failed: ${jobId} - ${error} (${retryInfo})`);
+        this.emit('job-failed', updatedJob, { error });
+    }
+    /**
+     * Pause a job (stops scheduling but preserves state)
+     *
+     * @param jobId - Job ID
+     * @throws Error if job not found
+     */
+    pauseJob(jobId) {
+        const job = this.getJobOrThrow(jobId);
+        const updatedJob = pauseJob(job);
+        this.jobs.set(jobId, updatedJob);
+        this.logger.debug(`Job paused: ${jobId}`);
+        this.emit('job-paused', updatedJob);
+    }
+    /**
+     * Resume a paused job
+     *
+     * @param jobId - Job ID
+     * @throws Error if job not found
+     */
+    resumeJob(jobId) {
+        const job = this.getJobOrThrow(jobId);
+        const updatedJob = resumeJob(job);
+        this.jobs.set(jobId, updatedJob);
+        this.logger.debug(`Job resumed: ${jobId}, next run: ${updatedJob.schedule.nextRun}`);
+        this.emit('job-resumed', updatedJob);
+    }
+    /**
+     * Reset a failed job for retry
+     *
+     * @param jobId - Job ID
+     * @throws Error if job not found
+     */
+    resetJob(jobId) {
+        const job = this.getJobOrThrow(jobId);
+        const updatedJob = resetJob(job);
+        this.jobs.set(jobId, updatedJob);
+        this.logger.debug(`Job reset: ${jobId}`);
+    }
+    /**
+     * Update job interval
+     *
+     * @param jobId - Job ID
+     * @param intervalMs - New interval in milliseconds
+     * @throws Error if job not found
+     */
+    updateJobInterval(jobId, intervalMs) {
+        const job = this.getJobOrThrow(jobId);
+        const updatedJob = {
+            ...job,
+            schedule: {
+                ...job.schedule,
+                intervalMs,
+            },
+        };
+        this.jobs.set(jobId, updatedJob);
+        this.logger.debug(`Job interval updated: ${jobId} -> ${intervalMs}ms`);
+    }
+    /**
+     * Load jobs from persisted state
+     *
+     * @param jobs - Array of persisted jobs
+     */
+    loadJobs(jobs) {
+        this.jobs.clear();
+        for (const job of jobs) {
+            this.jobs.set(job.id, job);
+        }
+        this.logger.debug(`Loaded ${jobs.length} jobs from persistence`);
+    }
+    /**
+     * Get all jobs for persistence
+     *
+     * @returns Array of all jobs
+     */
+    getJobsForPersistence() {
+        return this.getAllJobs();
+    }
+    /**
+     * Add an event listener
+     *
+     * @param listener - Callback function
+     */
+    addEventListener(listener) {
+        this.listeners.add(listener);
+    }
+    /**
+     * Remove an event listener
+     *
+     * @param listener - Callback function
+     */
+    removeEventListener(listener) {
+        this.listeners.delete(listener);
+    }
+    /**
+     * Get scheduler statistics
+     *
+     * @returns Scheduler stats
+     */
+    getStats() {
+        const jobs = this.getAllJobs();
+        const byStatus = {};
+        const byType = {};
+        for (const job of jobs) {
+            byStatus[job.status] = (byStatus[job.status] || 0) + 1;
+            byType[job.type] = (byType[job.type] || 0) + 1;
+        }
+        return {
+            totalJobs: jobs.length,
+            byStatus,
+            byType,
+            dueCount: this.getNextDueJobs().length,
+        };
+    }
+    /**
+     * Emit an event to all listeners
+     */
+    emit(event, job, data) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event, job, data);
+            }
+            catch (err) {
+                this.logger.error(`Error in job scheduler event listener: ${err}`);
+            }
+        }
+    }
+    /**
+     * Get a job or throw if not found
+     */
+    getJobOrThrow(jobId) {
+        const job = this.jobs.get(jobId);
+        if (!job) {
+            throw new Error(`Job not found: ${jobId}`);
+        }
+        return job;
+    }
+}
+//# sourceMappingURL=job-scheduler.js.map

package/dist/src/core/scheduler/job-scheduler.js.map

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

package/dist/src/core/scheduler/schedule-persistence.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Schedule Persistence
+ *
+ * Persists job schedules to disk so they survive session restarts.
+ * Uses atomic writes to prevent corruption.
+ *
+ * @module core/scheduler/schedule-persistence
+ */
+import { ScheduledJob } from './scheduled-job.js';
+import { Logger } from '../../utils/logger.js';
+/**
+ * Schedule persistence options
+ */
+export interface SchedulePersistenceOptions {
+    /**
+     * Path to .specweave directory
+     * @default process.cwd() + '/.specweave'
+     */
+    specweavePath?: string;
+    /**
+     * Logger instance
+     */
+    logger?: Logger;
+}
+/**
+ * SchedulePersistence - Saves and loads job schedules from disk
+ *
+ * Features:
+ * - Atomic writes using temp file + rename
+ * - Schema versioning for migration
+ * - Corruption recovery with defaults
+ */
+export declare class SchedulePersistence {
+    private readonly filePath;
+    private readonly logger;
+    constructor(options?: SchedulePersistenceOptions);
+    /**
+     * Load schedules from disk
+     *
+     * @returns Array of persisted jobs, empty array if file doesn't exist or is corrupted
+     */
+    loadSchedules(): Promise<ScheduledJob[]>;
+    /**
+     * Save schedules to disk
+     *
+     * Uses atomic write (write to temp file, then rename) to prevent corruption.
+     *
+     * @param jobs - Jobs to persist
+     */
+    saveSchedules(jobs: ScheduledJob[]): Promise<void>;
+    /**
+     * Update a single job in persistence
+     *
+     * @param jobId - Job ID to update
+     * @param updates - Partial job updates
+     */
+    updateJob(jobId: string, updates: Partial<ScheduledJob>): Promise<void>;
+    /**
+     * Delete a job from persistence
+     *
+     * @param jobId - Job ID to delete
+     */
+    deleteJob(jobId: string): Promise<void>;
+    /**
+     * Check if persistence file exists
+     *
+     * @returns true if file exists
+     */
+    exists(): Promise<boolean>;
+    /**
+     * Get file path (for testing/debugging)
+     */
+    getFilePath(): string;
+    /**
+     * Migrate schedules from older schema versions
+     */
+    private migrateSchedules;
+    /**
+     * Backup corrupted file for debugging
+     */
+    private backupCorruptedFile;
+}
+//# sourceMappingURL=schedule-persistence.d.ts.map

package/dist/src/core/scheduler/schedule-persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedule-persistence.d.ts","sourceRoot":"","sources":["../../../../src/core/scheduler/schedule-persistence.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AA2B9D;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAEpB,OAAO,GAAE,0BAA+B;IAMpD;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IA4C9C;;;;;;OAMG;IACG,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BxD;;;;;OAKG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAa7E;;;;OAIG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU7C;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAShC;;OAEG;IACH,WAAW,IAAI,MAAM;IAIrB;;OAEG;YACW,gBAAgB;IAM9B;;OAEG;YACW,mBAAmB;CASlC"}