memento-mcp-server 1.13.1-a2 → 1.13.1-a4

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

@@ -0,0 +1,195 @@
+/**
+ * 배치 작업 스케줄러
+ * TTL 기반 메모리 정리 및 기타 주기적 작업을 자동화
+ * Memento MCP Server의 핵심 배치 처리 컴포넌트
+ */
+import Database from 'better-sqlite3';
+import { ReflexionWorker } from '../reflexion-worker.js';
+export interface BatchJobConfig {
+    cleanupInterval: number;
+    monitoringInterval: number;
+    healthCheckInterval: number;
+    consolidationScoreIncrementalInterval: number;
+    consolidationScoreFullSweepInterval: number;
+    consolidationScoreFullSweepHour: number;
+    relationValidationInterval: number;
+    relationValidationDayOfWeek: number;
+    relationValidationHour: number;
+    maxBatchSize: number;
+    enableLogging: boolean;
+    enableNotifications: boolean;
+    enableMetrics: boolean;
+    maxConcurrentJobs: number;
+    jobTimeout: number;
+    retryAttempts: number;
+    retryDelay: number;
+}
+export interface BatchJobResult {
+    jobType: string;
+    startTime: Date;
+    endTime: Date;
+    duration: number;
+    success: boolean;
+    processed: number;
+    errors: string[];
+    warnings: string[];
+    details?: any;
+    retryCount?: number;
+}
+export interface SchedulerStatus {
+    isRunning: boolean;
+    activeJobs: string[];
+    lastExecution: Map<string, Date>;
+    totalExecutions: Map<string, number>;
+    errorCount: Map<string, number>;
+    uptime: number;
+    config: BatchJobConfig;
+}
+export declare class BatchScheduler {
+    private config;
+    private forgettingService;
+    private performanceMonitor;
+    private consolidationScoreWorker;
+    private reflexionWorker;
+    private db;
+    private intervals;
+    private isRunning;
+    private startTime;
+    private lastExecution;
+    private totalExecutions;
+    private errorCount;
+    private runningJobs;
+    private jobQueue;
+    private jobProcessorInterval;
+    constructor(config?: Partial<BatchJobConfig>);
+    /**
+     * 스케줄러 시작
+     * @param db 데이터베이스 인스턴스
+     * @param reflexionWorker Reflexion Worker 인스턴스 (선택적)
+     */
+    start(db: Database.Database, reflexionWorker?: ReflexionWorker): Promise<void>;
+    /**
+     * 스케줄러 중지
+     */
+    stop(): Promise<void>;
+    /**
+     * 설정 검증
+     */
+    private validateConfig;
+    /**
+     * 작업 스케줄링
+     */
+    private scheduleJob;
+    /**
+     * 작업 큐 처리기 시작
+     */
+    private startJobProcessor;
+    /**
+     * 타임아웃과 함께 작업 실행
+     */
+    private executeWithTimeout;
+    /**
+     * 실행 중인 작업 완료 대기
+     */
+    private waitForRunningJobs;
+    /**
+     * 메모리 정리 작업 실행
+     */
+    private runMemoryCleanup;
+    /**
+     * 모니터링 작업 실행
+     */
+    private runMonitoring;
+    /**
+     * 헬스체크 작업 실행
+     */
+    private runHealthCheck;
+    /**
+     * Consolidation Score 증분 재계산 작업 실행
+     */
+    private runConsolidationScoreIncremental;
+    /**
+     * Consolidation Score 전체 스윕 작업 스케줄링
+     * 지정된 시간에 하루 1회 실행
+     */
+    private scheduleConsolidationScoreFullSweep;
+    /**
+     * 주간 관계 추출 품질 검증 작업 스케줄링
+     */
+    private scheduleWeeklyRelationValidation;
+    /**
+     * 주간 관계 추출 품질 검증 실행
+     */
+    private runWeeklyRelationValidation;
+    /**
+     * Consolidation Score 전체 스윕 작업 실행
+     */
+    private runConsolidationScoreFullSweep;
+    /**
+     * 데이터베이스 통계 수집
+     */
+    private getDatabaseStats;
+    /**
+     * 로깅
+     */
+    private log;
+    /**
+     * 파일 로깅 (에러 로그)
+     */
+    private logToFile;
+    /**
+     * 밀리초를 사람이 읽기 쉬운 형태로 변환
+     * @param milliseconds 밀리초
+     * @returns 포맷된 시간 문자열 (예: "2h 30m 15s", "45s", "1d 3h")
+     */
+    private formatUptime;
+    /**
+     * 수동으로 작업 실행
+     */
+    runJob(jobType: 'cleanup' | 'monitoring' | 'healthcheck'): Promise<BatchJobResult>;
+    /**
+     * 스케줄러 상태 확인
+     */
+    getStatus(): SchedulerStatus;
+    /**
+     * 설정 업데이트
+     */
+    updateConfig(newConfig: Partial<BatchJobConfig>): void;
+    /**
+     * 특정 작업 중지
+     */
+    stopJob(jobName: string): boolean;
+    /**
+     * 특정 작업 재시작
+     */
+    restartJob(jobName: string): boolean;
+    /**
+     * 스케줄러 헬스체크
+     */
+    private checkSchedulerHealth;
+    /**
+     * 스케줄러 통계 조회
+     */
+    getDetailedStats(): {
+        status: SchedulerStatus;
+        health: {
+            memoryUsage: number;
+            runningJobs: number;
+            queueSize: number;
+            errorRate: number;
+            uptime: number;
+        };
+        jobs: Array<{
+            name: string;
+            lastExecution: Date | null;
+            totalExecutions: number;
+            errorCount: number;
+            errorRate: number;
+            isRunning: boolean;
+        }>;
+    };
+}
+export declare function getBatchScheduler(): BatchScheduler;
+export declare function createBatchScheduler(config?: Partial<BatchJobConfig>): BatchScheduler;
+export declare function resetBatchScheduler(): void;
+//# sourceMappingURL=batch-scheduler.d.ts.map

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

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