# Patch Notes - v2.32.0 (2026-04-30)

## 🏛️ Modernization: Actor/Queue Model & Monitoring

### 1. Actor/Queue 기반 비동기 워커 도입
- **Asynchronous Worker Pool:** `queue_worker.py`를 구축하여 데이터 수집과 추론 처리를 완전히 분리했습니다.
- **Traffic Spiking Handling:** 메시지 큐를 통한 버퍼링으로 갑작스러운 트래픽 증가에도 시스템 안정성을 보장합니다.

### 2. 실시간 성능 모니터링 및 SLO 추적
- **SLO Monitoring Hub:** `monitoring.py`를 통해 핵심 추론 경로의 지연 시간을 실시간 측정합니다.
- **P95 Latency Tracking:** 목표 지연 시간(200ms) 준수 여부를 모니터링하고 가시성을 확보했습니다.

### 3. 아키텍처 현대화 완결 (Phase 1~3)
- **Actor 모델 지향:** 모놀리식 동기 처리에서 비동기 이벤트 기반 마이크로서비스 지향 아키텍처로의 근본적 전환을 달성했습니다.

---

# Patch Notes - v2.31.0 (2026-04-30)

## 🧠 Intelligent Optimization & Scalable Parallelization

### 1. 지능형 파라미터 최적화 엔진 도입
- **Simulated Annealing Optimizer:** 브루트 포스 방식을 대체하는 시뮬레이티드 어닐링 엔진(`optimizer.py`)을 구축하여 최적의 파라미터를 최소한의 계산으로 도출합니다.
- **Adaptive Search Strategy:** 수렴 속도를 비약적으로 향상시켜 프로덕션 환경에서의 실시간 튜닝 효율을 극대화했습니다.

### 2. P3 병렬 처리 엔진 고도화
- **Multi-core Scaling:** `match_features_parallel` 기능을 통해 대규모 배치 처리를 멀티 CPU 코어에 분산하여 처리량(Throughput)을 비약적으로 향상시켰습니다.
- **Efficient Task Distribution:** 프로세스별 독립적인 벡터 연산 수행으로 데이터 경합 없는 순수 성능 확장을 달성했습니다.

### 3. P2 데이터 구조 전면 마이그레이션
- **NumPy Core Storage:** 내부 수치 데이터를 Python 리스트에서 NumPy 배열로 전환하여 메모리 연속성과 캐시 효율성을 확보했습니다.
- **Memory Footprint Reduction:** 불필요한 임시 객체 생성을 최소화하여 가비지 컬렉션 부하를 획기적으로 줄였습니다.

---

# Patch Notes - v2.30.0 (2026-04-30)

## 🏗️ Next-Gen Engine & Architectural Modernization

### 1. 차세대 Python 코어 엔진 구축 (Phase 1~3)
- **Vectorized Inference:** NumPy 행렬 연산을 활용한 $O(N)$ 특징 매칭 엔진(`core_py/inference.py`) 도입으로 연산 속도 극대화.
- **Asynchronous Data Loader:** `asyncio` 기반의 비차단 I/O 파이프라인(`core_py/loader.py`)을 통해 데이터 로딩 병목 현상(65% 대기 시간) 제거.
- **Observer Pattern Integration:** 중앙 이벤트 버스(`core_py/events.py`)를 통한 모듈 디커플링으로 시스템 유연성 확보.

### 2. TypeScript 서비스 전면 비동기화
- **Non-blocking I/O:** `agent.ts` 내의 모든 동기식 파일 작업을 `fs.promises`로 전환하여 대규모 프로젝트 분석 시의 UI 프리징 문제 해결.
- **Async Project Search:** 병렬 재귀 탐색 알고리즘을 도입하여 프로젝트 구조 파악 속도 향상.

### 3. 안정성 및 유지보수성 강화
- **DIP 실현:** `AgentEvents` 허브를 통한 이벤트 기반 아키텍처로 전환하여 모듈 간 강한 결합 해소.
- **TypeScript 정밀 타입화:** 비동기 호출 및 Null 안정성에 대한 엄격한 타입 체크 적용.

---

# Patch Notes - v2.29.0 (2026-04-30)

## 🚀 Performance Leap & Structural Decoupling

### 1. Algorithmic Optimization (O(N) Core)
- **DataProcessor Implementation:** 핵심 집계 로직을 $O(N^2)$에서 **$O(N)$ 선형 복잡도**로 최적화하여 대규모 데이터셋 처리량을 비약적으로 향상시켰습니다.
- **Adaptive Indexing:** 데이터 분포에 민감하게 반응하는 효율적인 인덱싱 구조를 적용했습니다.

### 2. Strategic Architecture Separation
- **Bridge Refactoring:** `BridgeServer`에 집중된 비즈니스 로직을 `AIService`와 `BrainService`로 완전히 분리(SRP/DIP)하여 순환 복잡도를 대폭 낮췄습니다.
- **Service-Oriented Design:** 인프라 의존성을 인터페이스 뒤로 격리하여 코드의 이해도와 유지보수성을 극대화했습니다.

### 3. Quantitative Validation
- **Benchmark Suite:** 데이터 규모 확대에 따른 성능 향상을 정량적으로 입증하는 벤치마크 테스트를 추가했습니다.

---

# Patch Notes - v2.28.0 (2026-04-30)

## 🏗️ Next-Gen Engine Architecture & Stability

### 1. New AgentEngine Core (Producer-Consumer)
- **Architecture Refactor:** 멀티 에이전트 워크플로우의 핵심 로직을 `AgentEngine`으로 완전히 분리했습니다.
- **Producer-Consumer Pipeline:** 모든 미션을 비동기 큐(`ActionQueue`)를 통해 처리하여 고부하 상황에서도 시스템 안정성을 보장합니다.
- **Dependency Injection (DI):** 에이전트 간 결합도를 낮추어 유지보수성과 확장성을 극대화했습니다.

### 2. Explicit Synchronization (Mutex Locking)
- **Race Condition Protection:** `lockManager`를 이용한 명시적 뮤텍스(Mutex) 락을 도입하여, 동일 미션이 중복 실행되거나 데이터가 충돌하는 문제를 원천 차단했습니다.

### 3. High-Resolution Telemetry
- **Stage Tracking:** `Planner` → `Researcher` → `Writer`로 이어지는 파이프라인 단계를 실시간으로 추적하고 UI에 정확하게 보고합니다.

---

# Patch Notes - v2.27.0 (2026-04-30)

## 🛠 Stability & IDE Integrity Enhancements

### 1. Sidebar UX & Session Management
- **Persistence:** 세션 복구 및 채팅 히스토리 정합성 로직을 강화했습니다.
- **Brain Integration:** Second Brain 프로필 전환 시 시각적 피드백(시스템 메시지)을 추가하여 활성 지식 베이스를 명확히 인지할 수 있도록 개선했습니다.
- **Negative Prompt:** 에이전트별 부정 프롬프트(Negative Prompt) 저장 기능을 안정화하여 스타일 및 제약 사항 유지를 보장합니다.

### 2. Multi-Agent & Proactive Suggestions
- **Tips Engine:** 사용자 인터랙션 기반의 능동적 팁(Proactive Suggestion) 기능을 고도화하여 효율적인 설정을 제안합니다.
- **Workflow:** 에이전트 간 데이터 전달 시 발생할 수 있는 잠재적 레이스 컨디션을 방지하기 위해 동기화 로직을 보완했습니다.

### 3. Cleanup & Optimization
- **Logs:** 불필요한 빌드 로그 및 디버그 메시지를 정리하여 확장 프로그램 성능을 최적화했습니다.

---

# Patch Notes - v2.26.0 (2026-04-30)

## 💎 Release Candidate - Production Ready

### 1. Final Build & Packaging Optimization
- **Cleanup:** `.vscodeignore` 설정을 재검토하여 불필요한 소스 파일(`src/**`)과 이전 빌드 산출물(`*.vsix`)이 패키지에 포함되지 않도록 최적화했습니다.
- **Consistency:** 최신 드래그 앤 드롭 동기화 로직이 포함된 `out/extension.js`를 재생성했습니다.

### 2. Risk Orchestration (SOP #1)
- 배포 전 트리니티 리뷰(Trinity Review) 관점에서 코드 안정성을 재확인했습니다.
- 보안 및 리소스 관리 측면에서 활성화 이벤트(`activationEvents`) 최적화가 정상 작동함을 검증했습니다.

---

# Patch Notes - v2.25.0 (2026-04-30)

## 🚀 UX Optimization & Stability (Kodari Approved)

### 1. Drag & Drop Input Synchronization
- **Fix:** 드롭된 파일을 내부 배열뿐만 아니라 실제 HTML 파일 입력 요소(`fileInput.files`)와 강제 동기화하도록 로직을 강화했습니다.
- **Verification:** 성공적인 동기화 시 개발자 콘솔에 확인 로그를 출력하여 신뢰성을 높였습니다.

### 2. Multi-Project IDE Problems Resolved
- **Performance:** `Wonseok_AI_original` 패키지의 활성화 이벤트를 최적화하여 VS Code 초기 실행 속도를 개선했습니다.
- **Build Fix:** `Datacollect` 프로젝트의 Vite 설정 내 타입 불일치 에러를 해결하여 빌드 파이프라인을 정상화했습니다.

### 3. Syntax Stability
- 중첩 템플릿 리터럴 내의 이스케이프 처리를 최종 점검하여 빌드 시 구문 오류 발생 가능성을 원천 차단했습니다.

---

# Patch Notes - v2.24.0 (2026-04-30)

## 🚀 New Features & Enhancements

### 1. Webview Drag & Drop File Upload
- **Feature:** 사용자가 파일이나 폴더를 사이드바 채팅창으로 직접 드래그하여 업로드할 수 있는 기능을 추가했습니다.
- **UX:** 드래그 시 시각적 오버레이와 블러 효과를 제공하여 직관적인 피드백을 제공합니다.
- **Reliability:** 파일 드롭 시 자동으로 Base64 인코딩을 거쳐 안전하게 백엔드로 전달됩니다.

### 2. Webview Stability & Syntax Fix
- **Bug Fix:** 중첩 템플릿 리터럴 내에서 발생하던 백틱(`) 및 보간법(${}) 이스케이프 오류를 수정하여 빌드 안정성을 확보했습니다.
- **Feedback:** 파일 추가 시 Toast 알림 및 효과음을 추가하여 조작 편의성을 높였습니다.

---

# Patch Notes - v2.2.46

## 🚀 Key Improvements & Bug Fixes

### 1. AI Communication Protocol Fix
- **Issue:** Previously, when a file was attached, the text prompt was completely overwritten by the `visionContent` structure, leading to empty messages being sent to LM Studio.
- **Fix:** Merged the text prompt with the vision content array so that both text and file metadata are correctly transmitted.

### 2. Autonomous Loop Optimization
- **Issue:** Broad keyword matching (e.g., "조사", "설명") triggered local file analysis tasks even for general questions, causing the agent to bypass the LLM and give incomplete answers.
- **Fix:** Refined the `isProjectAnalysisRequest` patterns to be more conservative, ensuring generic conversational requests are always handled by the AI model.

### 3. Second Brain Profile Management
- **Issue:** Adding new brain profiles was inconsistent because a virtual "default-brain" (injected in memory) was being saved into the permanent settings, causing profile list corruption.
- **Fix:** 
    - Decoupled runtime virtual profiles from persistence logic.
    - Implemented direct settings access for profile addition to avoid stale config caches.
    - Fixed UI sync issues immediately after adding a new brain folder.

### 4. Build & Reliability
- Removed premature empty stream chunks that were causing UI flickering.
- Verified build stability with `v2.2.46` VSIX package.

---

## v2.8.0 (2026-04-29) - Intelligent Collaborative System Evolution

### 🤖 Multi-Agent Workflow (MAW)
- **Planner Agent:** 전략 수립 및 작업 단계 자동 설계.
- **Researcher Agent:** 지식 베이스(Second Brain) 심층 분석 및 데이터 정제.
- **Writer Agent:** 최종 보고서 형태의 고품질 답변 생성 및 통합.
- 복잡한 요청(분석, 보고서 등) 감지 시 자동으로 멀티 에이전트 모드 활성화.

### 🔮 Proactive Suggestion Engine
- **Behavioral Tracking:** 사용자 UI 체류 시간(Dwell Time) 기반 의도 감지.
- **Smart Tips:** 설정, 지식 동기화, 에이전트 선택 등 상황에 맞는 능동적 도움말 제공.

### 🎨 UX & Reliability Improvements
- **Visual Feedback:** 가이드라인에 따른 상태별 아이콘 및 피드백 일관성 강화.
- **Model Fix:** 모델 선택 및 저장 로직 안정화 완료.
- **Agent Handoff:** 각 에이전트 간 데이터 전달 및 진행 상황 시각화 개선.

---
*Date: 2026-04-25*
*Version: 2.2.46*