selvage-lab/selvage

[0.1.6] - 2025-08-15

Added

feat: 멀티턴 리뷰 시스템 구현

핵심 변경사항

• 자동 컨텍스트 제한 처리: LLM API의 컨텍스트 제한 초과 시 자동으로 프롬프트를 분할하여 순차 처리 후 결과를 지능적으로 합성하는 멀티턴 리뷰 시스템 구현
• 지능적 프롬프트 분할: 토큰 정보와 텍스트 길이를 고려한 그리디 알고리즘 기반 최적 분할 (안전 여유분 20% 확보)
• LLM 기반 결과 합성: Summary는 LLM을 활용한 지능적 합성, 실패 시 fallback 로직 적용

세부 구현사항

• MultiturnReviewExecutor: 멀티턴 리뷰 프로세스의 메인 조정자 역할
• PromptSplitter: 토큰 비율 계산 및 텍스트 길이 기반 균등 분배 알고리즘
• ReviewSynthesizer: Issues 단순 합산, Summary LLM 합성, Recommendations 중복 제거를 통한 지능적 결과 합성
• SynthesisAPIClient & SynthesisPromptManager: 모든 LLM 프로바이더 지원하는 통합 API 호출 및 작업별 프롬프트 관리

성능 최적화 및 안정성

• 순차 처리 방식: OpenRouter 동시성 문제 해결을 위한 병렬 처리에서 순차 처리로 전환
• 정확한 비용 계산: 전체 청크 처리 비용과 합성 비용의 투명한 계산 및 표시
• 에러 패턴 개선: Anthropic의 새로운 context limit 에러 패턴 추가, max_tokens 값 64000으로 증가

문서화 및 개발 가이드

• 상세 시스템 문서: .cursor/rules/multiturn-review-system.mdc 추가로 컴포넌트 의존성, 워크플로우, 분할 전략 등 포괄적 문서화
• 아키텍처 통합: 기존 워크플로우 문서에 멀티턴 처리 단계 통합하여 전체 시스템 이해도 향상