memento-mcp-server 1.15.0 → 1.16.0-b

package/dist/services/quality-assurance/quality-assurance-service.d.ts.map

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

package/dist/services/quality-assurance/quality-assurance-service.js

@@ -0,0 +1,247 @@
+/**
+ * Quality Assurance Service
+ *
+ * 중앙 품질 관리 서비스 (Orchestrator)
+ *
+ * 주요 기능:
+ * - Collector, Evaluator, Recorder, Reporter 통합
+ * - 품질 측정 실행 (수집 -> 평가 -> 기록)
+ * - 리포트 생성
+ * - 배치 작업 지원
+ *
+ * PRD FR-1.1: Orchestrator 역할 - 전체 품질 관리 플로우 조율
+ */
+import Database from 'better-sqlite3';
+import { QualityMetricsCollector } from './quality-metrics-collector.js';
+import { QualityEvaluator } from './quality-evaluator.js';
+import { QualityRecorder } from './quality-recorder.js';
+import { QualityReporter } from './quality-reporter.js';
+import { QualityThresholdManager } from './quality-threshold-manager.js';
+import { logger } from '../../shared/utils/logger.js';
+/**
+ * Quality Assurance Service
+ *
+ * PRD FR-1.1: Orchestrator 역할 - 전체 품질 관리 플로우 조율
+ */
+export class QualityAssuranceService {
+    db;
+    collector;
+    evaluator;
+    recorder;
+    reporter;
+    thresholdManager;
+    constructor(db) {
+        this.db = db;
+        if (!db) {
+            throw new Error('Database instance is required');
+        }
+        this.collector = new QualityMetricsCollector(db);
+        this.evaluator = new QualityEvaluator(db);
+        this.recorder = new QualityRecorder(db);
+        this.reporter = new QualityReporter(db);
+        this.thresholdManager = new QualityThresholdManager(db);
+    }
+    /**
+     * 품질 측정 실행
+     *
+     * 전체 플로우: 수집 -> 평가 -> 기록
+     *
+     * PRD FR-3.1: 배치 작업을 통해 주기적으로 품질을 측정해야 함
+     *
+     * @param options - 측정 옵션
+     * @returns 측정 결과
+     */
+    async measureQuality(options = {}) {
+        const { measurement_type = 'batch', context = 'default', namespaces, record = true } = options;
+        const measuredAt = new Date().toISOString();
+        logger.info(`품질 측정 시작: ${namespaces ? namespaces.join(', ') : 'all'} (${context})`, {
+            measurement_type,
+            context,
+            namespaces
+        });
+        try {
+            // 1. 품질 지표 수집
+            let collectedMetricsList;
+            if (namespaces && namespaces.length > 0) {
+                // 특정 네임스페이스만 수집
+                collectedMetricsList = await Promise.all(namespaces.map(ns => this.collector.collectMetricsByNamespace(ns, context)));
+            }
+            else {
+                // 모든 네임스페이스 수집
+                collectedMetricsList = await this.collector.collectAllMetrics(context);
+            }
+            // 2. 품질 평가
+            const evaluationResults = await this.evaluator.evaluateAllMetrics(collectedMetricsList, context);
+            // 3. 전체 상태 결정
+            const overallStatus = this.evaluator.determineOverallStatus(evaluationResults);
+            // 4. 경고 개수 계산
+            const warningCount = evaluationResults.reduce((sum, result) => sum + result.warnings.length, 0);
+            // 5. 측정 결과 기록 (옵션)
+            let measurementIds = [];
+            if (record) {
+                measurementIds = await this.recorder.recordAllMeasurements(collectedMetricsList, evaluationResults, { measurement_type, context });
+            }
+            // 6. 경고 로그 기록
+            if (warningCount > 0) {
+                logger.warn(`품질 저하 감지: ${warningCount}개 경고`, {
+                    measurement_type,
+                    context,
+                    namespaces: namespaces || 'all',
+                    overall_status: overallStatus,
+                    warning_count: warningCount
+                });
+            }
+            const result = {
+                measured_at: measuredAt,
+                namespaces: namespaces || collectedMetricsList.map(m => m.namespace),
+                collected_metrics: collectedMetricsList,
+                evaluation_results: evaluationResults,
+                measurement_ids: measurementIds,
+                overall_status: overallStatus,
+                warning_count: warningCount
+            };
+            logger.info(`품질 측정 완료: ${overallStatus} (${warningCount}개 경고)`, {
+                measurement_type,
+                context,
+                namespaces: result.namespaces,
+                overall_status: overallStatus,
+                warning_count: warningCount,
+                metrics_count: collectedMetricsList.length
+            });
+            return result;
+        }
+        catch (error) {
+            logger.error('품질 측정 실패', {
+                measurement_type,
+                context,
+                namespaces,
+                error: error instanceof Error ? error.message : String(error)
+            });
+            throw error;
+        }
+    }
+    /**
+     * 품질 리포트 생성
+     *
+     * PRD FR-5.1: CLI 명령어로 품질 리포트를 생성할 수 있어야 함
+     * PRD FR-5.2: HTTP API 엔드포인트로 품질 리포트를 조회할 수 있어야 함
+     *
+     * @param options - 리포트 옵션
+     * @returns 리포트 문자열
+     */
+    async generateReport(options = {}) {
+        return this.reporter.generateReport(options);
+    }
+    /**
+     * 품질 리포트 데이터 조회
+     *
+     * @param options - 리포트 옵션
+     * @returns 리포트 데이터
+     */
+    async getReportData(options = {}) {
+        return this.reporter.collectReportData(options);
+    }
+    /**
+     * 기본 품질 임계값 초기화
+     *
+     * PRD FR-4.1: 품질 임계값을 정의하고 관리할 수 있어야 함
+     *
+     * @param context - 컨텍스트 (기본값: 'default')
+     * @param overwrite - 기존 임계값 덮어쓰기 여부 (기본값: false)
+     * @returns 초기화된 임계값 개수
+     */
+    initializeDefaultThresholds(context = 'default', overwrite = false) {
+        return this.thresholdManager.initializeDefaultThresholds(context, overwrite);
+    }
+    /**
+     * 품질 임계값 조회
+     *
+     * @param namespace - 네임스페이스 필터 (선택적)
+     * @param context - 컨텍스트 필터 (선택적)
+     * @returns 임계값 목록
+     */
+    getThresholds(namespace, context) {
+        return this.thresholdManager.getAllThresholds(namespace, context);
+    }
+    /**
+     * 품질 임계값 설정
+     *
+     * @param namespace - 네임스페이스
+     * @param key - 지표 키
+     * @param threshold_value - 임계값
+     * @param threshold_type - 임계값 타입 ('min' | 'max')
+     * @param description - 설명 (선택적)
+     * @param context - 컨텍스트 (기본값: 'default')
+     * @returns 설정된 임계값
+     */
+    setThreshold(namespace, key, threshold_value, threshold_type, description, context = 'default') {
+        return this.thresholdManager.setThreshold(namespace, key, { threshold_value, threshold_type, description }, context);
+    }
+    /**
+     * 품질 임계값 삭제
+     *
+     * @param namespace - 네임스페이스
+     * @param key - 지표 키
+     * @param context - 컨텍스트 (기본값: 'default')
+     * @returns 삭제 성공 여부
+     */
+    deleteThreshold(namespace, key, context = 'default') {
+        return this.thresholdManager.deleteThreshold(namespace, key, context);
+    }
+    /**
+     * 측정 이력 조회
+     *
+     * @param namespace - 네임스페이스 필터 (선택적)
+     * @param context - 컨텍스트 필터 (선택적)
+     * @param from - 시작 시간 (선택적)
+     * @param to - 종료 시간 (선택적)
+     * @param limit - 최대 개수 (기본값: 100)
+     * @returns 측정 이력 목록
+     */
+    getMeasurementHistory(namespace, context, from, to, limit = 100) {
+        return this.recorder.getMeasurementHistory(namespace, context, from, to, limit);
+    }
+    /**
+     * 최신 품질 지표 조회
+     *
+     * @param namespace - 네임스페이스 필터 (선택적)
+     * @param context - 컨텍스트 필터 (선택적)
+     * @returns 최신 품질 지표 목록
+     */
+    getLatestMetrics(namespace, context) {
+        return this.recorder.getLatestMetrics(namespace, context);
+    }
+    /**
+     * 배치 작업용 품질 측정
+     *
+     * PRD FR-3.1: 배치 작업을 통해 주기적으로 품질을 측정해야 함
+     *
+     * @param context - 컨텍스트 (기본값: 'default')
+     * @returns 측정 결과
+     */
+    async runBatchMeasurement(context = 'default') {
+        return this.measureQuality({
+            measurement_type: 'batch',
+            context,
+            record: true
+        });
+    }
+    /**
+     * 테스트용 품질 측정
+     *
+     * PRD FR-3.2: CI/CD 파이프라인에서 테스트 시 품질을 측정해야 함
+     *
+     * @param context - 컨텍스트 (기본값: 'ci')
+     * @param namespaces - 측정할 네임스페이스 목록 (선택적)
+     * @returns 측정 결과
+     */
+    async runTestMeasurement(context = 'ci', namespaces) {
+        return this.measureQuality({
+            measurement_type: 'test',
+            context,
+            namespaces,
+            record: true
+        });
+    }
+}
+//# sourceMappingURL=quality-assurance-service.js.map

package/dist/services/quality-assurance/quality-assurance-service.js.map

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

package/dist/services/quality-assurance/quality-evaluator.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Quality Evaluator
+ *
+ * 품질 평가 서비스
+ *
+ * 주요 기능:
+ * - 임계값 비교 및 품질 평가
+ * - 상태 결정: pass/warning/fail
+ * - 경고 정보 생성
+ *
+ * PRD FR-1.1: Evaluator 역할 - 임계값 비교 및 품질 평가
+ * PRD FR-4.2: 품질 측정 시 임계값을 검증해야 함
+ */
+import Database from 'better-sqlite3';
+import { type QualityThreshold } from './quality-threshold-manager.js';
+import type { CollectedMetrics } from './quality-metrics-collector.js';
+/**
+ * 지표 평가 결과
+ */
+export interface MetricEvaluationResult {
+    /**
+     * 네임스페이스
+     */
+    namespace: string;
+    /**
+     * 지표 키
+     */
+    key: string;
+    /**
+     * 측정값
+     */
+    value: number;
+    /**
+     * 임계값 정보
+     */
+    threshold: QualityThreshold | null;
+    /**
+     * 통과 여부
+     */
+    passed: boolean;
+    /**
+     * 차이 (측정값 - 임계값, 또는 임계값 - 측정값)
+     * 양수면 여유, 음수면 부족
+     */
+    difference: number | null;
+    /**
+     * 평가 메시지
+     */
+    message: string;
+}
+/**
+ * 품질 평가 결과
+ */
+export interface QualityEvaluationResult {
+    /**
+     * 네임스페이스
+     */
+    namespace: string;
+    /**
+     * 컨텍스트
+     */
+    context: string;
+    /**
+     * 전체 상태: 'pass', 'warning', 'fail'
+     */
+    status: 'pass' | 'warning' | 'fail';
+    /**
+     * 각 지표별 평가 결과
+     */
+    metricResults: MetricEvaluationResult[];
+    /**
+     * 통과한 지표 수
+     */
+    passedCount: number;
+    /**
+     * 실패한 지표 수
+     */
+    failedCount: number;
+    /**
+     * 총 지표 수
+     */
+    totalCount: number;
+    /**
+     * 경고 정보 (임계값 미달 시)
+     */
+    warnings: Array<{
+        metric_key: string;
+        value: number;
+        threshold_value: number;
+        difference: number;
+        message: string;
+    }>;
+    /**
+     * 평가 시간
+     */
+    evaluated_at: string;
+}
+/**
+ * Quality Evaluator
+ *
+ * PRD FR-1.1: Evaluator 역할 - 임계값 비교 및 품질 평가
+ */
+export declare class QualityEvaluator {
+    private db;
+    private thresholdManager;
+    constructor(db: Database.Database);
+    /**
+     * 단일 지표 평가
+     *
+     * @param namespace - 네임스페이스
+     * @param key - 지표 키
+     * @param value - 측정값
+     * @param context - 컨텍스트 (기본값: 'default')
+     * @returns 지표 평가 결과
+     */
+    evaluateMetric(namespace: string, key: string, value: number, context?: string): MetricEvaluationResult;
+    /**
+     * 품질 지표 평가
+     *
+     * PRD FR-4.2: 품질 측정 시 임계값을 검증해야 함
+     *
+     * @param metrics - 수집된 품질 지표
+     * @param context - 컨텍스트 (기본값: 'default')
+     * @returns 품질 평가 결과
+     */
+    evaluateMetrics(metrics: CollectedMetrics, context?: string): Promise<QualityEvaluationResult>;
+    /**
+     * 여러 네임스페이스의 품질 지표 평가
+     *
+     * @param metricsList - 수집된 품질 지표 목록
+     * @param context - 컨텍스트 (기본값: 'default')
+     * @returns 품질 평가 결과 목록
+     */
+    evaluateAllMetrics(metricsList: CollectedMetrics[], context?: string): Promise<QualityEvaluationResult[]>;
+    /**
+     * 전체 상태 결정
+     *
+     * 여러 네임스페이스의 평가 결과를 종합하여 전체 상태를 결정
+     *
+     * @param evaluationResults - 평가 결과 목록
+     * @returns 전체 상태: 'pass', 'warning', 'fail'
+     */
+    determineOverallStatus(evaluationResults: QualityEvaluationResult[]): 'pass' | 'warning' | 'fail';
+    /**
+     * 경고 정보 생성
+     *
+     * PRD FR-4.2: 경고 로그에 상세 정보 포함 (지표명, 측정값, 임계값, 차이)
+     *
+     * @param evaluationResult - 평가 결과
+     * @returns 경고 정보 (JSON 형식)
+     */
+    generateWarningInfo(evaluationResult: QualityEvaluationResult): string;
+    /**
+     * 경고 로그를 파일에 기록
+     *
+     * PRD FR-4.3: 품질 저하 발생 시 구조화된 JSON 로그 기록
+     * `logs/quality-warnings-{date}.log` 형식으로 저장
+     *
+     * @param evaluationResult - 평가 결과
+     */
+    private logWarningToFile;
+}
+//# sourceMappingURL=quality-evaluator.d.ts.map

package/dist/services/quality-assurance/quality-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quality-evaluator.d.ts","sourceRoot":"","sources":["../../../src/services/quality-assurance/quality-evaluator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,OAAO,EAA2B,KAAK,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAChG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAGvE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAEnC;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IAEpC;;OAEG;IACH,aAAa,EAAE,sBAAsB,EAAE,CAAC;IAExC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,KAAK,CAAC;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;QACd,eAAe,EAAE,MAAM,CAAC;QACxB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC,CAAC;IAEH;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,gBAAgB;IAGf,OAAO,CAAC,EAAE;IAFtB,OAAO,CAAC,gBAAgB,CAA0B;gBAE9B,EAAE,EAAE,QAAQ,CAAC,QAAQ;IAOzC;;;;;;;;OAQG;IACH,cAAc,CACZ,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,MAAkB,GAC1B,sBAAsB;IAyBzB;;;;;;;;OAQG;IACG,eAAe,CACnB,OAAO,EAAE,gBAAgB,EACzB,OAAO,GAAE,MAAkB,GAC1B,OAAO,CAAC,uBAAuB,CAAC;IA+EnC;;;;;;OAMG;IACG,kBAAkB,CACtB,WAAW,EAAE,gBAAgB,EAAE,EAC/B,OAAO,GAAE,MAAkB,GAC1B,OAAO,CAAC,uBAAuB,EAAE,CAAC;IAIrC;;;;;;;OAOG;IACH,sBAAsB,CAAC,iBAAiB,EAAE,uBAAuB,EAAE,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM;IAmBjG;;;;;;;OAOG;IACH,mBAAmB,CAAC,gBAAgB,EAAE,uBAAuB,GAAG,MAAM;IAyBtE;;;;;;;OAOG;YACW,gBAAgB;CAgD/B"}

package/dist/services/quality-assurance/quality-evaluator.js

@@ -0,0 +1,256 @@
+/**
+ * Quality Evaluator
+ *
+ * 품질 평가 서비스
+ *
+ * 주요 기능:
+ * - 임계값 비교 및 품질 평가
+ * - 상태 결정: pass/warning/fail
+ * - 경고 정보 생성
+ *
+ * PRD FR-1.1: Evaluator 역할 - 임계값 비교 및 품질 평가
+ * PRD FR-4.2: 품질 측정 시 임계값을 검증해야 함
+ */
+import Database from 'better-sqlite3';
+import fsPromises from 'fs/promises';
+import path from 'path';
+import { QualityThresholdManager } from './quality-threshold-manager.js';
+import { logger } from '../../shared/utils/logger.js';
+/**
+ * Quality Evaluator
+ *
+ * PRD FR-1.1: Evaluator 역할 - 임계값 비교 및 품질 평가
+ */
+export class QualityEvaluator {
+    db;
+    thresholdManager;
+    constructor(db) {
+        this.db = db;
+        if (!db) {
+            throw new Error('Database instance is required');
+        }
+        this.thresholdManager = new QualityThresholdManager(db);
+    }
+    /**
+     * 단일 지표 평가
+     *
+     * @param namespace - 네임스페이스
+     * @param key - 지표 키
+     * @param value - 측정값
+     * @param context - 컨텍스트 (기본값: 'default')
+     * @returns 지표 평가 결과
+     */
+    evaluateMetric(namespace, key, value, context = 'default') {
+        const validation = this.thresholdManager.validateThreshold(namespace, key, value, context);
+        let difference = null;
+        if (validation.threshold) {
+            if (validation.threshold.threshold_type === 'min') {
+                // min 타입: value - threshold_value (양수면 여유, 음수면 부족)
+                difference = value - validation.threshold.threshold_value;
+            }
+            else if (validation.threshold.threshold_type === 'max') {
+                // max 타입: threshold_value - value (양수면 여유, 음수면 부족)
+                difference = validation.threshold.threshold_value - value;
+            }
+        }
+        return {
+            namespace,
+            key,
+            value,
+            threshold: validation.threshold,
+            passed: validation.passed,
+            difference,
+            message: validation.message
+        };
+    }
+    /**
+     * 품질 지표 평가
+     *
+     * PRD FR-4.2: 품질 측정 시 임계값을 검증해야 함
+     *
+     * @param metrics - 수집된 품질 지표
+     * @param context - 컨텍스트 (기본값: 'default')
+     * @returns 품질 평가 결과
+     */
+    async evaluateMetrics(metrics, context = 'default') {
+        const metricResults = [];
+        const warnings = [];
+        // 각 지표를 평가
+        for (const [key, value] of Object.entries(metrics.metrics)) {
+            const result = this.evaluateMetric(metrics.namespace, key, value, context);
+            metricResults.push(result);
+            // 임계값 미달 시 경고 추가
+            if (!result.passed && result.threshold) {
+                warnings.push({
+                    metric_key: key,
+                    value,
+                    threshold_value: result.threshold.threshold_value,
+                    difference: result.difference || 0,
+                    message: result.message
+                });
+            }
+        }
+        // 상태 결정
+        const passedCount = metricResults.filter(r => r.passed).length;
+        const failedCount = metricResults.filter(r => !r.passed).length;
+        const totalCount = metricResults.length;
+        // 상태 결정 로직:
+        // - pass: 모든 지표가 통과
+        // - warning: 일부 지표가 실패했지만 심각하지 않음 (임계값이 설정되지 않은 경우는 제외)
+        // - fail: 중요한 지표가 실패 (임계값이 설정된 지표 중 실패)
+        let status = 'pass';
+        if (failedCount > 0) {
+            // 임계값이 설정된 지표 중 실패한 것이 있으면 fail
+            const failedWithThreshold = metricResults.filter(r => !r.passed && r.threshold !== null).length;
+            if (failedWithThreshold > 0) {
+                status = 'fail';
+            }
+            else {
+                // 임계값이 설정되지 않은 지표만 실패한 경우는 warning
+                status = 'warning';
+            }
+        }
+        // 평가 결과 생성
+        const evaluationResult = {
+            namespace: metrics.namespace,
+            context,
+            status,
+            metricResults,
+            passedCount,
+            failedCount,
+            totalCount,
+            warnings,
+            evaluated_at: new Date().toISOString()
+        };
+        // PRD FR-4.2: 경고 로그 기록
+        if (warnings.length > 0) {
+            logger.warn(`품질 저하 감지: ${metrics.namespace} (${context})`, {
+                namespace: metrics.namespace,
+                context,
+                warnings: warnings.map(w => ({
+                    metric: w.metric_key,
+                    value: w.value,
+                    threshold: w.threshold_value,
+                    difference: w.difference
+                }))
+            });
+            // PRD FR-4.3: 구조화된 JSON 로그 파일 기록
+            await this.logWarningToFile(evaluationResult);
+        }
+        return evaluationResult;
+    }
+    /**
+     * 여러 네임스페이스의 품질 지표 평가
+     *
+     * @param metricsList - 수집된 품질 지표 목록
+     * @param context - 컨텍스트 (기본값: 'default')
+     * @returns 품질 평가 결과 목록
+     */
+    async evaluateAllMetrics(metricsList, context = 'default') {
+        return Promise.all(metricsList.map(metrics => this.evaluateMetrics(metrics, context)));
+    }
+    /**
+     * 전체 상태 결정
+     *
+     * 여러 네임스페이스의 평가 결과를 종합하여 전체 상태를 결정
+     *
+     * @param evaluationResults - 평가 결과 목록
+     * @returns 전체 상태: 'pass', 'warning', 'fail'
+     */
+    determineOverallStatus(evaluationResults) {
+        if (evaluationResults.length === 0) {
+            return 'pass';
+        }
+        // fail이 하나라도 있으면 전체 fail
+        if (evaluationResults.some(r => r.status === 'fail')) {
+            return 'fail';
+        }
+        // warning이 하나라도 있으면 전체 warning
+        if (evaluationResults.some(r => r.status === 'warning')) {
+            return 'warning';
+        }
+        // 모두 pass면 전체 pass
+        return 'pass';
+    }
+    /**
+     * 경고 정보 생성
+     *
+     * PRD FR-4.2: 경고 로그에 상세 정보 포함 (지표명, 측정값, 임계값, 차이)
+     *
+     * @param evaluationResult - 평가 결과
+     * @returns 경고 정보 (JSON 형식)
+     */
+    generateWarningInfo(evaluationResult) {
+        if (evaluationResult.warnings.length === 0) {
+            return JSON.stringify({ warnings: [] });
+        }
+        const warningInfo = {
+            namespace: evaluationResult.namespace,
+            context: evaluationResult.context,
+            status: evaluationResult.status,
+            evaluated_at: evaluationResult.evaluated_at,
+            warnings: evaluationResult.warnings.map(w => ({
+                metric_key: w.metric_key,
+                value: w.value,
+                threshold_value: w.threshold_value,
+                threshold_type: evaluationResult.metricResults.find(r => r.key === w.metric_key)?.threshold?.threshold_type || 'unknown',
+                difference: w.difference,
+                message: w.message
+            }))
+        };
+        return JSON.stringify(warningInfo, null, 2);
+    }
+    /**
+     * 경고 로그를 파일에 기록
+     *
+     * PRD FR-4.3: 품질 저하 발생 시 구조화된 JSON 로그 기록
+     * `logs/quality-warnings-{date}.log` 형식으로 저장
+     *
+     * @param evaluationResult - 평가 결과
+     */
+    async logWarningToFile(evaluationResult) {
+        try {
+            const logDir = path.join(process.cwd(), 'logs');
+            // 로그 디렉토리 생성
+            try {
+                await fsPromises.access(logDir);
+            }
+            catch {
+                await fsPromises.mkdir(logDir, { recursive: true });
+            }
+            // 날짜별 로그 파일명 생성 (YYYY-MM-DD 형식)
+            const today = new Date().toISOString().split('T')[0];
+            const logFilePath = path.join(logDir, `quality-warnings-${today}.log`);
+            // 구조화된 JSON 로그 엔트리 생성
+            const logEntry = {
+                timestamp: evaluationResult.evaluated_at,
+                namespace: evaluationResult.namespace,
+                context: evaluationResult.context,
+                status: evaluationResult.status,
+                passed_count: evaluationResult.passedCount,
+                failed_count: evaluationResult.failedCount,
+                total_count: evaluationResult.totalCount,
+                warnings: evaluationResult.warnings.map(w => ({
+                    metric_key: w.metric_key,
+                    value: w.value,
+                    threshold_value: w.threshold_value,
+                    threshold_type: evaluationResult.metricResults.find(r => r.key === w.metric_key)?.threshold?.threshold_type || 'unknown',
+                    difference: w.difference,
+                    message: w.message
+                }))
+            };
+            // JSON Lines 형식으로 파일에 추가
+            const logLine = JSON.stringify(logEntry) + '\n';
+            await fsPromises.appendFile(logFilePath, logLine, 'utf-8');
+        }
+        catch (error) {
+            // 파일 로깅 실패는 콘솔 로거에 위임
+            logger.error('품질 경고 로그 파일 기록 실패', {
+                namespace: evaluationResult.namespace,
+                context: evaluationResult.context,
+                error: error instanceof Error ? error.message : String(error)
+            });
+        }
+    }
+}
+//# sourceMappingURL=quality-evaluator.js.map