memento-mcp-server 1.14.0 → 1.15.0-c

package/dist/infrastructure/logging/triple-extraction-logger.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Triple 추출 전용 로거
+ *
+ * rawLLMOutput을 로그 파일에 저장합니다.
+ *
+ * 보안 정책:
+ * - PII/비밀 정보 마스킹 적용
+ * - logs/triple-extraction/ 디렉토리에 저장
+ * - 날짜별 파일로 저장 (예: 2025-01-15.log)
+ * - 30일 로테이션 (2.16에서 구현)
+ * - 성공 케이스 10% 샘플링, 실패 케이스 100% 저장 (2.15에서 구현)
+ */
+import type { TripleExtractionResult } from '../../shared/types/triple-extraction.js';
+/**
+ * Triple 추출 로그 엔트리
+ */
+export interface TripleExtractionLogEntry {
+    timestamp: string;
+    memory_id?: string;
+    extraction_result: 'success' | 'failed';
+    triples_count: number;
+    failure_reason?: string;
+    steps?: {
+        canonicalization: boolean;
+        entityLinking: boolean;
+    };
+    raw_llm_output?: string;
+    observation_preview?: string;
+}
+/**
+ * Triple 추출 로거 설정
+ */
+export interface TripleExtractionLoggerConfig {
+    /**
+     * 로그 디렉토리 (기본: process.cwd()/logs/triple-extraction)
+     */
+    logDir?: string;
+    /**
+     * 로깅 활성화 여부 (기본: true)
+     */
+    enabled?: boolean;
+    /**
+     * PII 마스킹 활성화 여부 (기본: true)
+     */
+    enablePIIMasking?: boolean;
+}
+/**
+ * Triple 추출 전용 로거
+ */
+export declare class TripleExtractionLogger {
+    private config;
+    private logDir;
+    constructor(config?: TripleExtractionLoggerConfig);
+    /**
+     * Triple 추출 결과 로깅
+     *
+     * @param result Triple 추출 결과
+     * @param memoryId Episodic Memory ID (선택사항)
+     * @param observation Observation 텍스트 (선택사항, 미리보기용)
+     */
+    logExtraction(result: TripleExtractionResult, memoryId?: string, observation?: string): Promise<void>;
+    /**
+     * 로그 엔트리 생성
+     */
+    private createLogEntry;
+    /**
+     * 로그 디렉토리 생성
+     */
+    private ensureLogDirectory;
+    /**
+     * 날짜별 로그 파일 경로 반환
+     * 형식: YYYY-MM-DD.log
+     */
+    private getLogFilePath;
+    /**
+     * 로그 파일 목록 조회
+     *
+     * @returns 로그 파일 경로 배열
+     */
+    listLogFiles(): Promise<string[]>;
+    /**
+     * 오래된 로그 파일 삭제 (30일 이상)
+     *
+     * @param retentionDays 보존 기간 (일) (기본: 30일)
+     */
+    deleteOldLogs(retentionDays?: number): Promise<number>;
+}
+/**
+ * 싱글톤 인스턴스
+ */
+export declare const tripleExtractionLogger: TripleExtractionLogger;
+//# sourceMappingURL=triple-extraction-logger.d.ts.map

package/dist/infrastructure/logging/triple-extraction-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"triple-extraction-logger.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/logging/triple-extraction-logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,SAAS,GAAG,QAAQ,CAAC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE;QACN,gBAAgB,EAAE,OAAO,CAAC;QAC1B,aAAa,EAAE,OAAO,CAAC;KACxB,CAAC;IACF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAyC;IACvD,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,GAAE,4BAAiC;IASrD;;;;;;OAMG;IACG,aAAa,CACjB,MAAM,EAAE,sBAAsB,EAC9B,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IA4BhB;;OAEG;IACH,OAAO,CAAC,cAAc;IA4DtB;;OAEG;YACW,kBAAkB;IAShC;;;OAGG;IACH,OAAO,CAAC,cAAc;IAOtB;;;;OAIG;IACG,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAiBvC;;;;OAIG;IACG,aAAa,CAAC,aAAa,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,CAAC;CA+BjE;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,wBAA+B,CAAC"}

package/dist/infrastructure/logging/triple-extraction-logger.js

@@ -0,0 +1,194 @@
+/**
+ * Triple 추출 전용 로거
+ *
+ * rawLLMOutput을 로그 파일에 저장합니다.
+ *
+ * 보안 정책:
+ * - PII/비밀 정보 마스킹 적용
+ * - logs/triple-extraction/ 디렉토리에 저장
+ * - 날짜별 파일로 저장 (예: 2025-01-15.log)
+ * - 30일 로테이션 (2.16에서 구현)
+ * - 성공 케이스 10% 샘플링, 실패 케이스 100% 저장 (2.15에서 구현)
+ */
+import fs from 'fs';
+import fsPromises from 'fs/promises';
+import path from 'path';
+import { PIIMasker } from '../../shared/utils/pii-masker.js';
+/**
+ * Triple 추출 전용 로거
+ */
+export class TripleExtractionLogger {
+    config;
+    logDir;
+    constructor(config = {}) {
+        this.config = {
+            logDir: config.logDir ?? path.join(process.cwd(), 'logs', 'triple-extraction'),
+            enabled: config.enabled ?? true,
+            enablePIIMasking: config.enablePIIMasking !== false
+        };
+        this.logDir = this.config.logDir;
+    }
+    /**
+     * Triple 추출 결과 로깅
+     *
+     * @param result Triple 추출 결과
+     * @param memoryId Episodic Memory ID (선택사항)
+     * @param observation Observation 텍스트 (선택사항, 미리보기용)
+     */
+    async logExtraction(result, memoryId, observation) {
+        if (!this.config.enabled) {
+            return;
+        }
+        try {
+            // 로그 디렉토리 생성
+            await this.ensureLogDirectory();
+            // 로그 엔트리 생성
+            const entry = this.createLogEntry(result, memoryId, observation);
+            // 날짜별 로그 파일 경로
+            const logFilePath = this.getLogFilePath();
+            // 로그 엔트리 포맷팅 (JSON Lines 형식)
+            const logLine = JSON.stringify(entry) + '\n';
+            // 파일에 추가 (비동기)
+            await fsPromises.appendFile(logFilePath, logLine);
+        }
+        catch (error) {
+            // 파일 로깅 실패는 무시 (콘솔 로거 사용)
+            console.error('TripleExtractionLogger: 로그 파일 쓰기 실패', {
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+    /**
+     * 로그 엔트리 생성
+     */
+    createLogEntry(result, memoryId, observation) {
+        const extractionResult = result.triples.length > 0 ? 'success' : 'failed';
+        // rawLLMOutput 마스킹
+        let maskedRawOutput;
+        if (result.extractionInfo.rawLLMOutput) {
+            if (this.config.enablePIIMasking) {
+                const maskingResult = PIIMasker.mask(result.extractionInfo.rawLLMOutput);
+                maskedRawOutput = maskingResult.masked;
+            }
+            else {
+                maskedRawOutput = result.extractionInfo.rawLLMOutput;
+            }
+        }
+        // observation 미리보기 마스킹 (최대 200자)
+        let observationPreview;
+        if (observation) {
+            const preview = observation.length > 200
+                ? observation.substring(0, 200) + '...'
+                : observation;
+            if (this.config.enablePIIMasking) {
+                const maskingResult = PIIMasker.mask(preview);
+                observationPreview = maskingResult.masked;
+            }
+            else {
+                observationPreview = preview;
+            }
+        }
+        const entry = {
+            timestamp: new Date().toISOString(),
+            memory_id: memoryId,
+            extraction_result: extractionResult,
+            triples_count: result.triples.length,
+            steps: result.extractionInfo.steps
+        };
+        // 실패 시 failure_reason 추가
+        if (result.extractionInfo.failureReason) {
+            entry.failure_reason = result.extractionInfo.failureReason;
+        }
+        // rawLLMOutput 추가 (마스킹된)
+        if (maskedRawOutput) {
+            entry.raw_llm_output = maskedRawOutput;
+        }
+        // observation 미리보기 추가 (마스킹된)
+        if (observationPreview) {
+            entry.observation_preview = observationPreview;
+        }
+        return entry;
+    }
+    /**
+     * 로그 디렉토리 생성
+     */
+    async ensureLogDirectory() {
+        try {
+            await fsPromises.access(this.logDir);
+        }
+        catch {
+            // 디렉토리가 없으면 생성
+            await fsPromises.mkdir(this.logDir, { recursive: true });
+        }
+    }
+    /**
+     * 날짜별 로그 파일 경로 반환
+     * 형식: YYYY-MM-DD.log
+     */
+    getLogFilePath() {
+        const today = new Date();
+        const dateStr = today.toISOString().split('T')[0]; // YYYY-MM-DD
+        const fileName = `${dateStr}.log`;
+        return path.join(this.logDir, fileName);
+    }
+    /**
+     * 로그 파일 목록 조회
+     *
+     * @returns 로그 파일 경로 배열
+     */
+    async listLogFiles() {
+        try {
+            await this.ensureLogDirectory();
+            const files = await fsPromises.readdir(this.logDir);
+            return files
+                .filter(file => file.endsWith('.log'))
+                .map(file => path.join(this.logDir, file))
+                .sort()
+                .reverse(); // 최신 파일 먼저
+        }
+        catch (error) {
+            console.error('TripleExtractionLogger: 로그 파일 목록 조회 실패', {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return [];
+        }
+    }
+    /**
+     * 오래된 로그 파일 삭제 (30일 이상)
+     *
+     * @param retentionDays 보존 기간 (일) (기본: 30일)
+     */
+    async deleteOldLogs(retentionDays = 30) {
+        try {
+            await this.ensureLogDirectory();
+            const files = await fsPromises.readdir(this.logDir);
+            const now = Date.now();
+            const retentionMs = retentionDays * 24 * 60 * 60 * 1000;
+            let deletedCount = 0;
+            for (const file of files) {
+                if (!file.endsWith('.log')) {
+                    continue;
+                }
+                const filePath = path.join(this.logDir, file);
+                const stats = await fsPromises.stat(filePath);
+                const fileAge = now - stats.mtimeMs;
+                if (fileAge > retentionMs) {
+                    await fsPromises.unlink(filePath);
+                    deletedCount++;
+                }
+            }
+            return deletedCount;
+        }
+        catch (error) {
+            console.error('TripleExtractionLogger: 오래된 로그 파일 삭제 실패', {
+                error: error instanceof Error ? error.message : String(error)
+            });
+            return 0;
+        }
+    }
+}
+/**
+ * 싱글톤 인스턴스
+ */
+export const tripleExtractionLogger = new TripleExtractionLogger();
+//# sourceMappingURL=triple-extraction-logger.js.map

package/dist/infrastructure/logging/triple-extraction-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"triple-extraction-logger.js","sourceRoot":"","sources":["../../../src/infrastructure/logging/triple-extraction-logger.ts"],"names":[],"mappings":"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"}

package/dist/infrastructure/scheduler/batch-scheduler.d.ts

@@ -20,6 +20,11 @@ export interface BatchJobConfig {
     relationValidationInterval: number;
     relationValidationDayOfWeek: number;
     relationValidationHour: number;
+    logRotationInterval: number;
+    tripleExtractionInterval: number;
+    tripleExtractionHour?: number;
+    tripleExtractionBatchSize: number;
+    tripleExtractionTimeout: number;
     maxBatchSize: number;
     enableLogging: boolean;
     enableNotifications: boolean;
@@ -77,6 +82,7 @@ export declare class BatchScheduler {
     private healthChecker;
     private fileLogger;
     private relationValidatorExecutor;
+    private tripleExtractionBatchJob;
     constructor(config?: Partial<BatchJobConfig>, dependencies?: {
         jobQueue?: JobQueue;
         retryManager?: RetryManager;
@@ -113,8 +119,24 @@ export declare class BatchScheduler {
     /**
      * 큐에 작업 추가 (중복 방지 포함)
      * 동일 이름의 잡이 이미 큐에 있거나 실행 중이면 추가하지 않음
+     *
+     * PRD 6.2: 기존 배치 작업과 충돌 방지
+     * - 중복 방지: 동일 이름의 작업이 이미 큐에 있거나 실행 중이면 추가하지 않음
+     * - Triple 추출 배치 작업도 이 메커니즘을 통해 중복 실행 방지
+     * - 우선순위 기반 큐 관리로 중요한 작업 우선 처리
      */
     private addJobToQueue;
+    /**
+     * 외부에서 작업을 큐에 추가하는 public 메서드
+     * AriGraph Pipeline 등 외부 컴포넌트에서 사용
+     *
+     * @param name 작업 이름 (고유 식별자)
+     * @param job 실행할 작업 함수
+     * @param priority 우선순위 (낮을수록 높은 우선순위, 기본값: 10)
+     * @param retryCount 재시도 횟수 (기본값: 0)
+     * @returns 추가 성공 여부
+     */
+    addJob(name: string, job: () => Promise<void>, priority?: number, retryCount?: number): boolean;
     /**
      * 작업 스케줄링
      * 시작 시 maxConcurrentJobs를 보장하기 위해 무조건 큐를 통해 실행
@@ -124,6 +146,11 @@ export declare class BatchScheduler {
     /**
      * 작업 큐 처리기 시작
      * 재시도 큐에서도 동일한 래퍼(타임아웃+상태 관리)를 사용하도록 수정
+     *
+     * PRD 6.2: 기존 배치 작업과 충돌 방지
+     * - maxConcurrentJobs 설정을 통해 동시 실행 작업 수 제한
+     * - Triple 추출 배치 작업도 이 제한에 포함되어 다른 배치 작업과 충돌 방지
+     * - 우선순위 기반 실행으로 중요한 작업 우선 처리
      */
     private startJobProcessor;
     /**
@@ -210,6 +237,36 @@ export declare class BatchScheduler {
      * 스케줄러 헬스체크
      */
     private checkSchedulerHealth;
+    /**
+     * Triple 추출 배치 작업 실행
+     *
+     * PRD 6.1: 주기적 배치 실행
+     * - 대상: triple_extracted=false 또는 null인 Episodic Memory
+     * - 재시도 정책 적용 (최대 시도 횟수 확인)
+     * - abandoned 상태는 제외
+     */
+    private runTripleExtractionBatch;
+    /**
+     * Triple 추출 배치 작업 스케줄링
+     *
+     * PRD 6.1: 주기적 배치 실행
+     * - 주기: 매일 새벽 2시 (설정 가능, tripleExtractionInterval, tripleExtractionHour 설정)
+     * - tripleExtractionHour가 지정된 경우 해당 시간에만 실행
+     * - tripleExtractionHour가 지정되지 않은 경우 interval마다 실행
+     *
+     * PRD 6.2: 기존 배치 작업과 충돌 방지
+     * - BatchScheduler의 maxConcurrentJobs 설정 고려
+     * - Triple 추출 배치 작업은 다른 배치 작업과 동시 실행되지 않도록 스케줄링
+     * - Triple Extraction Job은 독립적인 작업 큐로 관리
+     * - 우선순위 6 설정 (로그 로테이션 다음, 다른 중요 작업보다 낮은 우선순위)
+     * - JobQueue를 통해 실행하여 maxConcurrentJobs 제한 및 중복 방지 적용
+     */
+    private scheduleTripleExtractionBatch;
+    /**
+     * 로그 로테이션 실행
+     * 30일 이상 된 Triple 추출 로그 파일을 삭제합니다.
+     */
+    private runLogRotation;
     /**
      * 스케줄러 통계 조회
      */

package/dist/infrastructure/scheduler/batch-scheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"batch-scheduler.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/scheduler/batch-scheduler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAE7E,MAAM,WAAW,cAAc;IAE7B,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qCAAqC,EAAE,MAAM,CAAC;IAC9C,mCAAmC,EAAE,MAAM,CAAC;IAC5C,+BAA+B,EAAE,MAAM,CAAC;IACxC,0BAA0B,EAAE,MAAM,CAAC;IACnC,2BAA2B,EAAE,MAAM,CAAC;IACpC,sBAAsB,EAAE,MAAM,CAAC;IAG/B,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,aAAa,EAAE,OAAO,CAAC;IAGvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,+BAA+B,CAAC,EAAE,MAAM,CAAC;CAC1C;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,EAAE,IAAI,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,GAAG,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACjC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,UAAU,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,cAAc,CAAC;CACxB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,iBAAiB,CAA0B;IACnD,OAAO,CAAC,kBAAkB,CAA2C;IACrE,OAAO,CAAC,wBAAwB,CAAyC;IACzE,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,EAAE,CAAkC;IAC5C,OAAO,CAAC,SAAS,CAA0D;IAC3E,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,aAAa,CAAgC;IACrD,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,oBAAoB,CAA+C;IAG3E,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,yBAAyB,CAA4B;gBAG3D,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,EAChC,YAAY,CAAC,EAAE;QACb,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,YAAY,CAAC,EAAE,YAAY,CAAC;QAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;QAC9B,UAAU,CAAC,EAAE,UAAU,CAAC;QACxB,yBAAyB,CAAC,EAAE,yBAAyB,CAAC;KACvD;IAmDH;;;;OAIG;IACG,KAAK,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAoEpF;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAuC3B;;OAEG;IACH,OAAO,CAAC,cAAc;IA6BtB;;;;;;;;;OASG;YACW,mBAAmB;IAiGjC;;;OAGG;IACH,OAAO,CAAC,aAAa;IAIrB;;;;OAIG;IACH,OAAO,CAAC,WAAW;IAenB;;;OAGG;IACH,OAAO,CAAC,iBAAiB;IAmBzB;;OAEG;YACW,kBAAkB;IAShC;;OAEG;YACW,kBAAkB;IAchC;;OAEG;YACW,gBAAgB;IAoD9B;;OAEG;YACW,aAAa;IAgE3B;;OAEG;YACW,cAAc;IA4C5B;;OAEG;YACW,gCAAgC;IAuD9C;;;;OAIG;IACH,OAAO,CAAC,mCAAmC;IAkC3C;;;OAGG;IACH,OAAO,CAAC,gCAAgC;IAkCxC;;;OAGG;YACW,2BAA2B;IAwDzC;;OAEG;YACW,8BAA8B;IAwD5C;;OAEG;YACW,gBAAgB;IA+B9B;;;OAGG;IACH,OAAO,CAAC,GAAG;IA6EX;;;;OAIG;IACH,OAAO,CAAC,YAAY;IA4BpB;;;OAGG;IACG,MAAM,CAAC,OAAO,EAAE,SAAS,GAAG,YAAY,GAAG,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IAwBxF;;OAEG;IACH,SAAS,IAAI,eAAe;IAsB5B;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI;IAMtD;;OAEG;IACH,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAWjC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAiBpC;;OAEG;YACW,oBAAoB;IAwClC;;OAEG;IACH,gBAAgB,IAAI;QAClB,MAAM,EAAE,eAAe,CAAC;QACxB,MAAM,EAAE;YACN,WAAW,EAAE,MAAM,CAAC;YACpB,WAAW,EAAE,MAAM,CAAC;YACpB,SAAS,EAAE,MAAM,CAAC;YAClB,SAAS,EAAE,MAAM,CAAC;YAClB,MAAM,EAAE,MAAM,CAAC;SAChB,CAAC;QACF,IAAI,EAAE,KAAK,CAAC;YACV,IAAI,EAAE,MAAM,CAAC;YACb,aAAa,EAAE,IAAI,GAAG,IAAI,CAAC;YAC3B,eAAe,EAAE,MAAM,CAAC;YACxB,UAAU,EAAE,MAAM,CAAC;YACnB,SAAS,EAAE,MAAM,CAAC;YAClB,SAAS,EAAE,OAAO,CAAC;SACpB,CAAC,CAAC;KACJ;CAgCF;AAKD,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,cAAc,CAErF;AAED,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C"}
+{"version":3,"file":"batch-scheduler.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/scheduler/batch-scheduler.ts"],"names":[],"mappings":"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"}