interface ReporterInput {
  analysisMode: string;
  projectContext: ProjectContext;
  changes: ChangesSummary;
  source: SourceInfo;
  categories: {
    simpleRefactoring: Change[];
    logicChanges: Change[];
    fileMovements: Change[];
    detailedChanges: Change[];
  };
  complexChanges: ComplexChange[];
}

# 코드 리뷰 - [Analysis Mode]

## 📊 리뷰 요약
[Project info, analysis mode, statistics]

## 🔄 단순 리팩토링
[Simple refactoring changes]

## 🧠 로직 변경사항
[Logic changes with before/after comparison]

## 🧠 복잡 로직 분석 (Complex Cases Only)
[ToT analysis results for complex changes]

## 📁 파일 이동 및 순서 변경
[File movements and reorganization]

## 📝 상세 변경 내역
[Other detailed changes]

## 🎯 리뷰 권장사항
[Prioritized recommendations]

## 📋 테스트 권장사항
[Testing recommendations]

---
**리뷰 날짜**: YYYY-MM-DD
**분석 모드**: [mode]
**리뷰어**: 자동화된 코드 리뷰 시스템

**기존 로직**:
\`\`\`typescript
// old code
\`\`\`

**신규 로직**:
\`\`\`typescript
// new code
\`\`\`

**변경된 파일**: 15개 파일
**추가된 라인**: +234
**삭제된 라인**: -128

# Generate review from evaluation output
korean-review-reporter --input evaluation.json --output review.md

const input: ReporterInput = {
  analysisMode: "comprehensive",
  projectContext: {
    name: "@canard/schema-form",
    version: "0.8.5",
    type: "library"
  },
  changes: {
    totalFiles: 15,
    linesAdded: 534,
    linesDeleted: 278,
    netChange: 256
  },
  source: {
    branch: "feat/form-type-input-refactor",
    author: "developer@example.com",
    timestamp: "2025-01-17T10:30:00Z"
  },
  categories: {
    simpleRefactoring: [
      {
        file: "packages/canard/schema-form/src/types/formTypeInput.ts",
        type: "rename",
        description: "FormTypeProps → FormTypeInputProps 타입명 변경",
        risk: "low",
        lineRange: "15-45"
      },
      {
        file: "packages/canard/schema-form/src/components/StringInput.tsx",
        type: "extract",
        description: "validation 로직을 별도 함수로 분리",
        risk: "low",
        lineRange: "67-89"
      }
    ],
    logicChanges: [
      {
        file: "packages/canard/schema-form/src/core/formEngine.ts",
        type: "logic_enhancement",
        description: "에러 처리 로직 강화",
        risk: "medium",
        before: "if (!value) return null;",
        after: "if (value === undefined || value === null) {\n  throw new ValidationError('Value required');\n}",
        lineRange: "123-135"
      }
    ],
    fileMovements: [
      {
        from: "src/utils/validators.ts",
        to: "src/validation/validators.ts",
        reason: "validation 관련 파일 그룹화"
      }
    ],
    detailedChanges: [
      {
        file: "README.md",
        type: "documentation",
        description: "FormTypeInput 사용 예시 업데이트",
        risk: "low"
      }
    ]
  },
  complexChanges: [
    {
      file: "packages/canard/schema-form/src/core/nodeFactory.ts",
      description: "ArrayNode 생성 로직 재설계",
      risk: "high",
      totAnalysis: {
        thoughts: [
          "기존 로직은 빈 배열 처리 시 에러 발생",
          "새 로직은 빈 배열을 정상 케이스로 처리",
          "하위 호환성 영향: 기존 빈 배열 검증에 의존하는 코드 영향받을 수 있음"
        ],
        risks: [
          "Breaking change 가능성",
          "기존 테스트 케이스 실패 가능"
        ],
        recommendations: [
          "마이그레이션 가이드 작성 필요",
          "deprecation warning 추가 권장"
        ]
      },
      lineRange: "200-250"
    }
  ]
};

# 코드 리뷰 - Comprehensive

## 📊 리뷰 요약

**프로젝트**: @canard/schema-form v0.8.5
**브랜치**: feat/form-type-input-refactor
**작성자**: developer@example.com
**분석 모드**: 종합 분석 (Comprehensive)

**변경 통계**:
- 변경된 파일: 15개
- 추가된 라인: +534
- 삭제된 라인: -278
- 순 변경: +256

---

## 🔄 단순 리팩토링

### 1. FormTypeProps → FormTypeInputProps 타입명 변경
- **파일**: `packages/canard/schema-form/src/types/formTypeInput.ts`
- **라인**: 15-45번째 라인
- **위험도**: 🟢 낮음
- **설명**: 타입명을 더 명확하게 변경하여 가독성 향상

### 2. validation 로직 분리
- **파일**: `packages/canard/schema-form/src/components/StringInput.tsx`
- **라인**: 67-89번째 라인
- **위험도**: 🟢 낮음
- **설명**: validation 로직을 별도 함수로 추출하여 재사용성 개선

---

## 🧠 로직 변경사항

### 1. 에러 처리 로직 강화
- **파일**: `packages/canard/schema-form/src/core/formEngine.ts`
- **라인**: 123-135번째 라인
- **위험도**: 🟡 보통

**기존 로직**:
```typescript
if (!value) return null;

if (value === undefined || value === null) {
  throw new ValidationError('Value required');
}

### 시나리오 2: 단순 버그 수정 PR 리뷰 보고서

**상황**: 2개 파일, 10줄 미만의 버그 수정

**입력 데이터**:
```typescript
const input: ReporterInput = {
  analysisMode: "quick",
  projectContext: {
    name: "@winglet/react-utils",
    version: "1.2.3",
    type: "library"
  },
  changes: {
    totalFiles: 2,
    linesAdded: 5,
    linesDeleted: 3,
    netChange: 2
  },
  source: {
    branch: "fix/useDebounce-memory-leak",
    author: "developer@example.com",
    timestamp: "2025-01-17T14:20:00Z"
  },
  categories: {
    simpleRefactoring: [],
    logicChanges: [
      {
        file: "packages/winglet/react-utils/src/hooks/useDebounce.ts",
        type: "bug_fix",
        description: "cleanup 함수 누락으로 인한 메모리 누수 수정",
        risk: "low",
        before: "useEffect(() => {\n  const timer = setTimeout(() => setDebouncedValue(value), delay);\n}, [value, delay]);",
        after: "useEffect(() => {\n  const timer = setTimeout(() => setDebouncedValue(value), delay);\n  return () => clearTimeout(timer);\n}, [value, delay]);",
        lineRange: "15-20"
      }
    ],
    fileMovements: [],
    detailedChanges: [
      {
        file: "packages/winglet/react-utils/CHANGELOG.md",
        type: "documentation",
        description: "버그 수정 내역 추가",
        risk: "low"
      }
    ]
  },
  complexChanges: []
};

# 코드 리뷰 - Quick

## 📊 리뷰 요약

**프로젝트**: @winglet/react-utils v1.2.3
**브랜치**: fix/useDebounce-memory-leak
**작성자**: developer@example.com
**분석 모드**: 빠른 분석 (Quick)

**변경 통계**:
- 변경된 파일: 2개
- 추가된 라인: +5
- 삭제된 라인: -3
- 순 변경: +2

---

## 🔄 단순 리팩토링
변경사항 없음

---

## 🧠 로직 변경사항

### 1. useDebounce 메모리 누수 수정
- **파일**: `packages/winglet/react-utils/src/hooks/useDebounce.ts`
- **라인**: 15-20번째 라인
- **위험도**: 🟢 낮음

**기존 로직**:
```typescript
useEffect(() => {
  const timer = setTimeout(() => setDebouncedValue(value), delay);
}, [value, delay]);

useEffect(() => {
  const timer = setTimeout(() => setDebouncedValue(value), delay);
  return () => clearTimeout(timer);
}, [value, delay]);

### 시나리오 3: 기능 추가 PR 리뷰 보고서

**상황**: 새로운 FormType 플러그인 추가 (7개 파일)

**입력 데이터**:
```typescript
const input: ReporterInput = {
  analysisMode: "standard",
  projectContext: {
    name: "@canard/schema-form",
    version: "0.8.6",
    type: "library"
  },
  changes: {
    totalFiles: 7,
    linesAdded: 320,
    linesDeleted: 15,
    netChange: 305
  },
  source: {
    branch: "feat/datetime-input",
    author: "developer@example.com",
    timestamp: "2025-01-17T16:45:00Z"
  },
  categories: {
    simpleRefactoring: [],
    logicChanges: [
      {
        file: "packages/canard/schema-form/src/plugins/DateTimeInput.tsx",
        type: "new_feature",
        description: "새로운 DateTime 입력 컴포넌트 추가",
        risk: "medium",
        lineRange: "1-150"
      },
      {
        file: "packages/canard/schema-form/src/plugins/index.ts",
        type: "export_addition",
        description: "DateTimeInput export 추가",
        risk: "low",
        before: "export { StringInput, NumberInput };",
        after: "export { StringInput, NumberInput, DateTimeInput };",
        lineRange: "10"
      }
    ],
    fileMovements: [],
    detailedChanges: [
      {
        file: "packages/canard/schema-form/src/plugins/DateTimeInput.test.tsx",
        type: "test",
        description: "DateTimeInput 단위 테스트 추가",
        risk: "low"
      },
      {
        file: "packages/canard/schema-form/README.md",
        type: "documentation",
        description: "DateTimeInput 사용 예시 추가",
        risk: "low"
      }
    ]
  },
  complexChanges: [
    {
      file: "packages/canard/schema-form/src/plugins/DateTimeInput.tsx",
      description: "날짜/시간 입력 및 타임존 처리 로직",
      risk: "medium",
      totAnalysis: {
        thoughts: [
          "ISO 8601 형식으로 날짜/시간 저장",
          "사용자 로컬 타임존과 UTC 변환 처리",
          "브라우저 호환성 고려 (Date API 사용)"
        ],
        risks: [
          "타임존 변환 시 오차 발생 가능성",
          "구형 브라우저에서 Date API 지원 제한"
        ],
        recommendations: [
          "date-fns 또는 dayjs 라이브러리 고려",
          "타임존 테스트 케이스 추가 권장"
        ]
      },
      lineRange: "45-120"
    }
  ]
};

# 코드 리뷰 - Standard

## 📊 리뷰 요약

**프로젝트**: @canard/schema-form v0.8.6
**브랜치**: feat/datetime-input
**작성자**: developer@example.com
**분석 모드**: 표준 분석 (Standard)

**변경 통계**:
- 변경된 파일: 7개
- 추가된 라인: +320
- 삭제된 라인: -15
- 순 변경: +305

---

## 🔄 단순 리팩토링
변경사항 없음

---

## 🧠 로직 변경사항

### 1. DateTime 입력 컴포넌트 추가
- **파일**: `packages/canard/schema-form/src/plugins/DateTimeInput.tsx`
- **라인**: 1-150번째 라인
- **위험도**: 🟡 보통
- **설명**: 새로운 DateTime 입력 컴포넌트 추가

### 2. DateTimeInput export 추가
- **파일**: `packages/canard/schema-form/src/plugins/index.ts`
- **라인**: 10번째 라인
- **위험도**: 🟢 낮음

**기존 로직**:
```typescript
export { StringInput, NumberInput };

export { StringInput, NumberInput, DateTimeInput };

### 시나리오 4: 보안 취약점 수정 PR 리뷰 보고서

**상황**: XSS 취약점 수정 (3개 파일)

**입력 데이터**:
```typescript
const input: ReporterInput = {
  analysisMode: "security_focused",
  projectContext: {
    name: "@aileron/user-dashboard",
    version: "2.1.0",
    type: "application"
  },
  changes: {
    totalFiles: 3,
    linesAdded: 25,
    linesDeleted: 18,
    netChange: 7
  },
  source: {
    branch: "security/fix-xss-vulnerability",
    author: "security@example.com",
    timestamp: "2025-01-17T11:00:00Z"
  },
  categories: {
    simpleRefactoring: [],
    logicChanges: [
      {
        file: "src/components/UserProfile.tsx",
        type: "security_fix",
        description: "사용자 입력 sanitize 추가",
        risk: "high",
        before: "<div>{user.bio}</div>",
        after: "<div>{sanitizeHtml(user.bio)}</div>",
        lineRange: "45"
      },
      {
        file: "src/utils/sanitize.ts",
        type: "new_utility",
        description: "HTML sanitize 유틸리티 함수 추가",
        risk: "medium",
        lineRange: "1-20"
      }
    ],
    fileMovements: [],
    detailedChanges: [
      {
        file: "package.json",
        type: "dependency",
        description: "DOMPurify 라이브러리 추가",
        risk: "low"
      }
    ]
  },
  complexChanges: [
    {
      file: "src/utils/sanitize.ts",
      description: "XSS 방어를 위한 HTML sanitization 로직",
      risk: "high",
      totAnalysis: {
        thoughts: [
          "DOMPurify 라이브러리를 사용하여 신뢰할 수 있는 sanitization",
          "허용된 태그 화이트리스트 정의 (p, br, strong, em만 허용)",
          "이벤트 핸들러 및 스크립트 태그 완전 제거"
        ],
        risks: [
          "과도한 sanitize로 정상 HTML도 제거될 가능성",
          "화이트리스트 관리 필요"
        ],
        recommendations: [
          "sanitize 정책을 설정 파일로 분리 권장",
          "허용된 태그 문서화 필요"
        ]
      },
      lineRange: "5-18"
    }
  ]
};

# 코드 리뷰 - Security Focused

## 📊 리뷰 요약

**프로젝트**: @aileron/user-dashboard v2.1.0
**브랜치**: security/fix-xss-vulnerability
**작성자**: security@example.com
**분석 모드**: 보안 중점 분석 (Security Focused)

**변경 통계**:
- 변경된 파일: 3개
- 추가된 라인: +25
- 삭제된 라인: -18
- 순 변경: +7

---

## 🔄 단순 리팩토링
변경사항 없음

---

## 🧠 로직 변경사항

### 1. 🔴 사용자 입력 sanitize 추가 (보안 수정)
- **파일**: `src/components/UserProfile.tsx`
- **라인**: 45번째 라인
- **위험도**: 🔴 높음

**기존 로직**:
```typescript
<div>{user.bio}</div>

<div>{sanitizeHtml(user.bio)}</div>

## Knowledge 파일 역할

### review-template-korean.md
**용도**: 한글 리뷰 보고서 마크다운 템플릿

**주요 내용**:
- 각 섹션별 헤더 및 구조
- 이모지 사용 가이드 (🔴🟡🟢 위험도, ✅⚠️ 체크 항목)
- 코드 블록 형식 (before/after 비교)
- 통계 표시 형식
- 액션 아이템 우선순위 표현

**예시**:
```markdown
## 🧠 로직 변경사항

### {번호}. {변경 제목}
- **파일**: `{파일경로}`
- **라인**: {시작}-{끝}번째 라인
- **위험도**: {🔴|🟡|🟢} {높음|보통|낮음}

**기존 로직**:
\`\`\`typescript
{이전 코드}
\`\`\`

**신규 로직**:
\`\`\`typescript
{새로운 코드}
\`\`\`

**변경 이유**:
{상세 설명}

**영향 범위**:
{영향받는 부분}

# 기술 용어
technical_terms:
  breaking_change: "브레이킹 체인지"
  refactoring: "리팩토링"
  merge_conflict: "머지 충돌"
  type_safety: "타입 안전성"
  code_coverage: "코드 커버리지"
  unit_test: "단위 테스트"
  integration_test: "통합 테스트"
  regression_test: "회귀 테스트"

# 위험도
risk_levels:
  critical: "🔴 위험"
  high: "🟠 높음"
  medium: "🟡 보통"
  low: "🟢 낮음"

# 액션 우선순위
action_priorities:
  must_do: "🔴 필수 조치"
  should_do: "🟡 권장 조치"
  consider: "🟢 고려 사항"

# 분석 모드
analysis_modes:
  comprehensive: "종합 분석 (Comprehensive)"
  standard: "표준 분석 (Standard)"
  quick: "빠른 분석 (Quick)"
  security_focused: "보안 중점 분석 (Security Focused)"

# 1단계: 품질 검사
code-quality-reviewer → quality_result.json

# 2단계: 한글 보고서 생성
korean-review-reporter quality_result.json → quality_report_ko.md

# 1단계: 영향도 평가
code-impact-evaluator → impact_result.json

# 2단계: 한글 보고서 생성
korean-review-reporter impact_result.json → impact_report_ko.md

# 1단계: 품질 검사
code-quality-reviewer → quality_result.json

# 2단계: 영향도 평가
code-impact-evaluator → impact_result.json

# 3단계: 통합 한글 보고서
korean-review-reporter quality_result.json impact_result.json → comprehensive_report_ko.md

report-generator (언어 중립적 보고서 생성기)
  ├── korean-review-reporter (한글 전용)
  ├── english-review-reporter (영문 전용)
  └── multilingual-reporter (다국어 지원)

error_handling:
  severity_high:
    conditions:
      - 입력 데이터 구조 불일치 (예상 JSON 스키마 위배)
      - 필수 섹션 누락 (impact_analysis, risk_score 등)
      - 번역 템플릿 파일 누락 (knowledge/translation_templates.yaml)
      - 마크다운 생성 실패 (파일 쓰기 권한 문제)
    action: |
      ❌ 치명적 오류 - 한글 보고서 생성 중단
      → 입력 데이터 스키마 검증: {input_schema}
      → 필수 섹션 확인: impact_analysis, risk_score, recommendations
      → 템플릿 파일 존재 확인: ls knowledge/translation_templates.yaml
      → 파일 쓰기 권한 확인: touch test_report.md
      → 재실행: 입력 데이터 수정 후 korean-review-reporter 호출
    examples:
      - condition: "입력 데이터 구조 불일치"
        message: "❌ 오류: 입력 데이터에 'impact_analysis' 필드가 없습니다"
        recovery: "code-impact-evaluator 출력 확인 후 재실행"
      - condition: "템플릿 파일 누락"
        message: "❌ 오류: knowledge/translation_templates.yaml을 찾을 수 없습니다"
        recovery: "템플릿 파일 복원 또는 스킬 재설치"

  severity_medium:
    conditions:
      - 일부 섹션 번역 실패 (알 수 없는 기술 용어)
      - 코드 블록 포맷팅 이슈
      - 선택적 섹션 누락 (test_recommendations 등)
      - 번역 품질 낮음 (기계 번역 감지)
    action: |
      ⚠️  경고 - 부분 번역으로 보고서 생성
      1. 번역 실패한 섹션은 원문 그대로 포함
      2. 보고서 상단에 경고 추가:
         > ⚠️  주의: 일부 섹션은 번역되지 않았습니다
         > → 다음 섹션 원문 포함: {untranslated_sections}
      3. 알 수 없는 용어는 괄호로 원문 병기
      4. 사용자에게 수동 검토 요청
    fallback_values:
      untranslated_section: "{ORIGINAL_TEXT}"
      technical_term: "{한글번역} ({original})"
    examples:
      - condition: "알 수 없는 기술 용어"
        message: "⚠️  경고: 'React Server Components'의 적절한 번역을 찾을 수 없습니다"
        fallback: "리액트 서버 컴포넌트 (React Server Components)로 표기"
      - condition: "선택적 섹션 누락"
        message: "⚠️  경고: test_recommendations 섹션이 입력 데이터에 없습니다"
        fallback: "해당 섹션 생략 → 보고서에 포함하지 않음"

  severity_low:
    conditions:
      - 번역 스타일 불일치 (존댓말 vs 평서체)
      - 마크다운 포맷팅 미세 조정 필요
      - 링크 텍스트 번역 생략
      - 이모지 위치 조정
    action: |
      ℹ️  정보: 미세 조정 필요 - 자동 처리
      → 기본 스타일 (존댓말) 적용
      → 마크다운 자동 정리
      → 링크는 원문 유지 (URL은 번역 불필요)
      → 이모지는 섹션 제목 앞에 배치
    examples:
      - condition: "스타일 불일치"
        auto_handling: "전체 보고서를 존댓말로 통일 (기본 스타일)"
      - condition: "링크 텍스트"
        auto_handling: "링크 텍스트는 원문 유지: [React Docs](https://react.dev)"