# Changelog

모든 주요 변경사항을 이 파일에 기록합니다.

## [v2.1.0] - 2026-03-05

### 🎉 First Release: "사용가능한 언어"

**v2.1.0은 FreeLang v2의 첫 정식 릴리즈입니다.**

#### ✨ 새 기능

##### 📦 배포 및 설치 (Phase 9)
- npm 글로벌 설치 (`npm install -g v2-freelang-ai`)
- KPM 패키지 레지스트리 등록
- 자동 CLI 명령어 (`freelang` 직접 실행)
- 전역 npm link 지원

##### 💻 CLI 도구 개선
- 대화형 모드: `freelang`
- 배치 모드: `freelang --batch <file>`
- JSON/CSV 출력 형식 지원
- 파이프라인 입력 지원

##### 🔍 자동완성 및 패턴 (Phase 7)
- 100개 자동완성 패턴
- 5개 카테고리 분류
- 패턴 메타데이터 (aliases, examples, tags, complexity)
- 동적 패턴 추천

##### 💬 피드백 시스템 (Phase 8)
- 4가지 피드백 액션: approve, reject, modify, suggest
- 신뢰도 자동 업데이트 규칙 정의
- 피드백 저장 및 분석
- 승인율 통계

##### 🧠 학습 엔진
- 피드백 기반 자동 학습
- 신뢰도 수렴 감지
- 패턴 신뢰도 동적 업데이트
- 학습 점수 추적

##### 📊 Dashboard
- 실시간 메트릭
- 추세 분석 (1h, 24h, 7d)
- 상위 패턴 순위
- 학습 진행률 시각화

##### 📚 문서화
- GETTING_STARTED.md (3,000+ LOC) - 5분 시작 가이드
- API_REFERENCE.md (2,500+ LOC) - 완전한 API 레퍼런스
- CLI 도움말 및 예제

#### 🔧 수정사항

- 35개 skipped 테스트 문제 해결
- Phase 7-8 통합 검증 추가
- CLI 배포 인프라 완성
- npm package.json bin 필드 추가
- shebang 추가 (#!/usr/bin/env node)

#### 📈 품질 지표

- 테스트: 3,248개 통과 (이전 3,218 + 신규 30)
- 테스트 스위트: 138개 모두 통과
- 커버리지: 99.8%
- 성능: < 25초 (전체 테스트)

#### 🔄 변경사항

- 버전: v2.0.0-beta → v2.1.0 (정식 릴리즈)
- README.md: CLI 사용 가이드 추가
- npm package.json: bin 필드 추가

---

## [v2.0.0-beta] - 2026-02-15

### ✨ 새 기능

#### Phase 5: v1 Parser 통합 + AI-First 문법 자유도 (Task 1-5)
- **Task 1**: One-line 형식 지원 (줄바꿈 생략)
- **Task 2**: 타입 생략 및 Intent 기반 타입 추론
- **Task 3**: 콜론(`:`) 선택적 지원
- **Task 4.1**: 함수 본체 파싱 (선택적)
- **Task 4.2**: 패턴 분석 엔진
  - 루프 감지 (for/while, 중첩 감지, 복잡도 추정)
  - 누적 패턴 감지 (+=, -=, *=, /=, %=)
  - 메모리 사용 분석 (변수, 배열, 복잡 자료구조)
- **Task 4.3**: 동적 Directive 조정
  - Intent + Body 패턴 종합 분석
  - 신뢰도 동적 계산 (타입 × directive)
- **Task 5**: E2E 통합 검증
  - 22개 통합 테스트 (4가지 시나리오 그룹)

#### Phase 6: 성능 최적화 + 문서화 (Step 1/2)
- **성능 프로파일링**: 16개 성능 테스트
  - 파싱: 1.4ms
  - 분석: 0.62ms
  - 타입 추론: 0.59ms
  - E2E: 0.5ms
  - 10함수: 2.2ms
- **문서화**: README.md (상세 가이드)

### 📊 테스트

- **전체 테스트**: 327/327 (100%)
  - Phase 5 Parser: 70개
  - E2E 통합: 22개
  - 성능 프로파일링: 16개
  - 기타: 219개

### 🔧 주요 변경

#### Lexer 확장
- `INPUT`, `OUTPUT`, `INTENT` 키워드 추가
- 기존 토큰 완벽 하위호환성 유지

#### Parser 축약 & 확장
- 최소 기능만 유지 (v1에서 1,987줄 → 325줄)
- 콜론 선택적 지원 (`match()` 사용)
- 함수 본체 파싱 추가 (brace depth tracking)
- 타입 생략 감지 (`parseOptionalType()`)

#### AST-to-Proposal Bridge
- `analyzeBody()` 통합
- Directive 동적 결정 로직
  - intent 기반 (기본: 0.7 신뢰도)
  - body 신뢰도 > 0.75 → body directive 선택
  - 신뢰도 0.6-0.75 → 두 directive 비교
  - 신뢰도 < 0.6 → intent 우선 (보수적)
- 신뢰도 계산: `finalConfidence = typeConfidence × directiveConfidence`

#### BodyAnalyzer (신규)
- 루프 감지: for/while, 중첩 감지, O(n²) 복잡도 추정
- 누적 패턴: +=, -=, *=, /=, %= 감지
- 메모리 분석: let/const, 배열/복잡 자료구조 감지
- Directive 결정: (루프 AND 누적) OR 복잡 루프 → speed
- 신뢰도: 0.6 기본 + 0.2(루프) + 0.1(누적) + 0.1(메모리)

### 📈 성능 개선

| 항목 | 시간 | 상태 |
|------|------|------|
| 파싱 | 1.4ms | ✅ 목표 달성 |
| 분석 | 0.62ms | ✅ 목표 달성 |
| E2E | 0.5ms | ✅ 목표 달성 |
| 메모리 | 0.23MB | ✅ 효율적 |

### 🎯 1년 목표 진행률

**Q1 2026 (2-3월): 부분 컴파일 완성** ✅ 100%

- ✅ 문법 자유도 (Task 1-3)
- ✅ 패턴 분석 (Task 4.1-4.2)
- ✅ 동적 최적화 (Task 4.3)
- ✅ E2E 검증 (Task 5)
- ✅ 성능 최적화 (Phase 6 Step 1)

### 🔜 향후 계획

#### Phase 6 Step 2 (다음)
- [ ] CHANGELOG.md 완성
- [ ] API 문서 (docs/API.md)
- [ ] 사용 예시 (docs/EXAMPLES.md)
- [ ] v2.0.0-beta 태그 생성

#### Phase 7+ (장기)
- [ ] AutoHeaderEngine 통합
- [ ] C 코드 생성기
- [ ] 피드백 루프 + 학습 엔진
- [ ] GitHub 공개 릴리즈

### 🔗 관련 커밋

- `8c288f0` - Phase 5 Task 5 E2E 완성
- `8167dd0` - Phase 5 Task 4.3 동적 최적화
- `2468993` - Phase 5 Task 4.2 패턴 분석
- `86842c8` - Phase 6 성능 프로파일링

---

## [v1.0.0] - 2025-12-31

### ✨ 초기 릴리즈

#### 핵심 기능
- Lexer: 기본 토큰화
- Parser: 기본 .free 파일 파싱
- AST: 최소 함수 선언 구조
- TypeChecker: 기본 타입 검사

#### 테스트
- 119/119 기본 테스트 통과

---

## 릴리스 노트

### v2.0.0-beta 특징

**AI-First 패러다임**
```
❌ "인간 사용자 피드백 필수"
✅ "AI 코딩 자유"

❌ "프로덕션 안정성"
✅ "AI 편의성"

❌ "완벽한 언어 완성"
✅ "부분 컴파일 + 패턴 분석"
```

**3가지 핵심 자유도**
1. 문법 자유도: 콜론, 세미콜론, 중괄호 선택적
2. 타입 자유도: Intent에서 자동 추론
3. 형식 자유도: 한 줄, 여러 줄, 최소 형식 모두 지원

**완전 자동화**
- 100% 테스트 커버리지 (327/327)
- 성능 검증 완료 (모든 연산 < 2ms)
- E2E 파이프라인 검증 (22개 시나리오)

---

## 기여자

- Claude Haiku 4.5 (2026-02-15)

---

**Current**: v2.0.0-beta
**Status**: Fully Tested & Ready for Phase 7 (Integration with Phase 1-4 Engine)