memento-mcp-server 1.12.0 → 1.13.0-b

package/dist/services/reflexion-worker.d.ts

@@ -0,0 +1,170 @@
+/**
+ * Reflexion Worker 서비스
+ * 실패 이벤트를 처리하여 reflection_notes를 자동 생성하고 저장
+ */
+import { FailureDetector, type FailureEvent } from './failure-detector.js';
+import { AsyncTaskQueue } from './async-optimizer.js';
+import Database from 'better-sqlite3';
+/**
+ * Worker 상태
+ */
+interface WorkerStatus {
+    isRunning: boolean;
+    activeWorkers: number;
+    queueSize: number;
+    processedCount: number;
+    failedCount: number;
+    restartCount: number;
+}
+/**
+ * ReflexionWorker 서비스 클래스
+ */
+export declare class ReflexionWorker {
+    private failureDetector;
+    private db;
+    private eventQueue;
+    private duplicateWindow;
+    private readonly WINDOW_SIZE_MS;
+    private readonly MAX_CONCURRENT;
+    private readonly MAX_QUEUE_SIZE;
+    private readonly MAX_RETRIES;
+    private readonly RETRY_DELAYS;
+    private readonly QUEUE_WARNING_THRESHOLD;
+    private readonly MAX_RESTART_ATTEMPTS;
+    private status;
+    private cleanupInterval;
+    private healthCheckInterval;
+    private lastHealthCheck;
+    constructor(failureDetector: FailureDetector, db: Database.Database, eventQueue?: AsyncTaskQueue);
+    /**
+     * Worker 시작
+     */
+    start(): Promise<boolean>;
+    /**
+     * Worker 중지
+     */
+    stop(): Promise<boolean>;
+    /**
+     * 헬스체크 시작
+     */
+    private startHealthCheck;
+    /**
+     * 헬스체크 수행
+     */
+    private performHealthCheck;
+    /**
+     * Worker 재시작 시도
+     */
+    private attemptRestart;
+    /**
+     * auto_reflect 내부 함수
+     * 실패 정보를 바탕으로 Reflexion 데이터 생성 및 저장
+     */
+    private autoReflect;
+    /**
+     * 중복 감지
+     */
+    private isDuplicate;
+    /**
+     * 이벤트 키 생성: SHA256({tool_name}_{error_type}_{error_message_hash})
+     */
+    private generateEventKey;
+    /**
+     * 중복 윈도우 정리 (만료된 항목 제거)
+     */
+    private cleanupDuplicateWindow;
+    /**
+     * Reflexion 데이터 생성
+     */
+    private generateReflectionNote;
+    /**
+     * 교훈 추출 (템플릿 기반)
+     */
+    private generateLessonsLearned;
+    /**
+     * 개선 방안 제안 (템플릿 기반)
+     */
+    private generateSuggestedImprovements;
+    /**
+     * 반복 실패 패턴 분석
+     * 동일 task_goal의 반복 실패 횟수 및 패턴을 분석
+     */
+    private analyzeFailurePattern;
+    /**
+     * 작업 목표 추출
+     */
+    private extractTaskGoal;
+    /**
+     * reflection_notes 파싱
+     */
+    private parseReflectionNotes;
+    /**
+     * FailureDetector의 큐에 핸들러 등록
+     * FailureDetector가 실패 이벤트를 큐에 추가할 때 이 핸들러를 사용하도록 설정
+     */
+    registerHandler(): void;
+    /**
+     * 실패 이벤트를 큐에 추가 (큐 크기 제한 포함)
+     * FailureDetector의 queueFailureEvent를 대체하는 메서드
+     * AsyncTaskQueue가 자동으로 큐 크기 제한을 처리함
+     */
+    queueFailureEvent(event: FailureEvent): Promise<boolean>;
+    /**
+     * 가장 오래된 큐 이벤트 제거 (FIFO)
+     * AsyncTaskQueue의 큐 크기 제한 기능을 사용하므로 여기서는 더 이상 필요 없음
+     * @deprecated AsyncTaskQueue가 자동으로 처리하므로 사용하지 않음
+     */
+    private removeOldestQueuedEvent;
+    /**
+     * 실패 이벤트 처리 (재시도 및 백오프 포함)
+     */
+    processFailureEvent(event: FailureEvent): Promise<void>;
+    /**
+     * Worker 상태 조회
+     */
+    getStatus(): WorkerStatus;
+    /**
+     * 큐 적체 경고 확인
+     */
+    checkQueueBacklog(): void;
+    /**
+     * Reflexion 기록 메트릭 수집
+     */
+    getReflexionMetrics(): {
+        processedCount: number;
+        failedCount: number;
+        successRate: number;
+        averageProcessingTime: number;
+        queueSize: number;
+        activeWorkers: number;
+        restartCount: number;
+    };
+    /**
+     * 통합 메트릭 수집 (FailureDetector + ReflexionWorker)
+     */
+    getIntegratedMetrics(): {
+        detection: {
+            totalDetections: number;
+            toolErrorCount: number;
+            userFeedbackCount: number;
+            metricFailureCount: number;
+            detectionRate: number;
+        };
+        reflexion: {
+            processedCount: number;
+            failedCount: number;
+            successRate: number;
+            averageProcessingTime: number;
+            queueSize: number;
+            activeWorkers: number;
+            restartCount: number;
+        };
+        overall: {
+            recall: number;
+            precision: number;
+            reflexionSuccessRate: number;
+        };
+    };
+}
+export {};
+//# sourceMappingURL=reflexion-worker.d.ts.map

package/dist/services/reflexion-worker.d.ts.map

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