# Astra Patch Notes

## v2.62.0 (2026-05-04)
### 🚀 Astra Autonomous Loop (AAL) 기초 구축
- **데이터 중앙화:** `.astra` 디렉토리를 프로젝트 루트에서 `ConnectAI/.astra/` 내부로 이전하여 프로젝트 응집도 향상.
- **AAL 프로토콜 도입:** 에이전트 간 자율 협업을 위한 `protocol.json` 및 `tasks.json` 스키마 구축.
- **경로 해결기(Path Resolver):** 확장 프로그램 설치 경로 기반의 데이터 관리 시스템(`astraPath.ts`) 도입.

### 🔍 파일 직접 분석 기능 강화
- **경로 감지 범용화:** 하드코딩된 경로 대신 `/Volumes/`, `/Users/`, `/home/`, `~/` 등 모든 절대 경로 감지 지원.
- **분석 키워드 확장:** "읽어줘", "열어줘", "파일 내용", "코드 분석" 등 직관적인 한국어/영어 트리거 추가.
- **대용량 프리뷰 지원:** 코드/문서 파일 분석 시 프리뷰 제한을 1,200자에서 **8,000자**로 대폭 상향하여 정밀 분석 가능.

---

# Patch Notes - v2.61.0 (2026-05-04)

## 🛡️ Resilient Engine & Monitoring (복원력 강화)
- **Error Recovery Matrix:** 에러 유형을 Transient(일시적)와 Permanent(영구적)로 자동 분류하는 복구 매트릭스가 전면 도입되었습니다. 네트워크 오류 시 지수 백오프 재시도를 자동 수행합니다.
- **Mission Control Dashboard:** `toStructuredLog()` 기반의 프리미엄 시각화 대시보드(`assets/mission_control.html`)가 추가되었습니다. 에이전트의 흐름과 지연 시간을 한눈에 파악할 수 있습니다.
- **성능 및 병렬화 최적화:** 단계별 500ms 강제 지연을 제거하고, Researcher와 Writer 준비 과정을 병렬화하여 전체 워크플로우 처리 속도를 대폭 향상했습니다.
- **신뢰성 검증:** 37종의 통합 테스트 및 성능 벤치마크 스위트를 통해 엔진의 안정성과 복구 메커니즘을 완벽히 검증했습니다.

---

# Patch Notes - v2.60.0 (2026-05-04)

## 🧠 Memory & Knowledge Search (Unified RAG Pipeline)
- **Retrieval Orchestrator:** 통합 RAG 파이프라인(`src/retrieval`)이 전면 도입되었습니다. 무거운 외부 프레임워크(LlamaIndex 등) 없이 자체적으로 초경량 TF-IDF 스코어링 및 컨텍스트 예산 최적화를 수행합니다.
- **2nd Brain (Obsidian) 연동:** 프로젝트 문서 및 옵시디언 지식 기지에서 질문과 연관된 핵심 문단을 자동 추출하여 AI 프롬프트에 주입합니다.
- **다중 메모리 계층 동시 탐색:** 과거 대화(Episodic), 프로젝트 결정 사항(Project), 문제 해결 절차(Procedural) 등 다양한 메모리를 융합하여 입체적인 답변을 제공하도록 강화되었습니다.

---

# Patch Notes - v2.59.0 (2026-05-03)

## 🎨 UI/UX Polish & Stability
- **Visual Consistency:** Refined the sidebar layout to ensure 100% alignment with the latest design guidelines.
- **Error Handling:** Improved the clarity of diagnostic messages during agent execution failures.
- **Workflow Persistence:** Fixed a minor edge case where the multi-agent execution state was not correctly reset after cancellation.

---

# Patch Notes - v2.58.0 (2026-05-03)

## 🛠️ Performance & Core Refinement
- **Workflow Orchestration:** Further optimized the agent handoff logic for smoother transition between reasoning stages.
- **Resource Management:** Enhanced memory cleanup during intensive multi-agent tasks to prevent UI lag.
- **System Stability:** Finalized the synchronization between core logic and UI event handlers.

---

# Patch Notes - v2.37.0 (2026-05-03)

## 🚀 Orchestration & System Stability
- **Version Normalization:** Synchronized system-wide versioning to v2.37.0 to align with the latest architectural refinements.
- **Build Pipeline Optimization:** Streamlined the VSIX packaging process for consistent distribution across environments.
- **Git Sync Strategy:** Enhanced the automated commit & push workflow to ensure 100% repository integrity after major updates.

---

# Patch Notes - v2.36.9 (2026-05-02)

## ✍️ Content Engineering: Blog Automation Standard
- **Blog Production Standard Manual:** Integrated the authoritative guide for structure, layout, and SEO-optimized headline design into the agent's reasoning core.
- **Tone & Manner Refinement:** Established the "Ryuri-style" persona (Friendly Expert) as the default for content-centric tasks to ensure high engagement and trust.
- **Knowledge Pipeline:** Synced the latest blog writing patterns from the Wiki into the extension's knowledge retrieval layer.

---

# Patch Notes - v2.36.8 (2026-05-02)

## 🔍 Intelligence & Stability: Review Preflight
- **Code Review Preflight:** Implemented a local path validation layer that verifies workspace integrity before initiating deep autonomous code analysis.
- **System Prompt Testing:** Added a suite of automated tests for system prompts to ensure consistent agent behavior across diverse reasoning tasks.

---

# Patch Notes - v2.36.7 (2026-05-02)

## 🎨 UX & Search Refinement
- **Answer Format Tuning:** Optimized response formatting to improve readability and visual clarity of synthesized information.
- **Query Intent Search:** Enhanced the intent-based search logic to provide more contextually relevant results from the knowledge base.

---

# Patch Notes - v2.36.6 (2026-05-02)

## 🛡️ Reliability Upgrade: Project Claim Output Brake
- **Output Brake Mechanism:** Introduced a strict filtering layer that prevents the agent from making unverified project claims.
- **Evidentiary Reasoning:** Refined the core logic to enforce a "No Evidence, No Claim" policy for higher architectural integrity.

---

# Patch Notes - v2.36.5 (2026-05-02)

## 🛡️ Project Governance: Guard Policy Enforcement
- **Project Chronicle Guard:** Implemented strict validation logic for project claims, ensuring all assertions are backed by verifiable evidence.
- **Trace Optimization:** Enhanced `SecondBrainTrace` for more precise knowledge tracking and context synthesis.

---

# Patch Notes - v2.36.4 (2026-05-02)

## 🏛️ Knowledge Integration: Datacollector Sync
- **Wiki Expansion:** Integrated 43 high-density technical artifacts from the Datacollector (Software Engineering, Architecture, DevOps).
- **v3.1 Standard Compliance:** All new artifacts processed with enhanced validation and duplicate check metadata.

---

# Patch Notes - v2.36.3 (2026-05-02)

## ⚙️ Core Orchestration Tuning
- **Signal Handling Optimization:** Refined the internal event bus to ensure smoother transitions between autonomous reasoning steps.
- **Distribution Integrity:** Final validation of build artifacts and metadata consistency for the v2.36 series.

---

# Patch Notes - v2.36.2 (2026-05-02)

## 📝 Documentation Fix
- **Repository URL Correction:** Fixed incorrect GitHub repository URLs in `README.md` and `package.json` to point to the authoritative `g1nations/locallm` repository.

---

# Patch Notes - v2.36.1 (2026-05-02)

## 🛠️ Stability & Refinement
- **Action Queue Optimization:** Refined the `ActionQueue` to handle rapid succession of wiki-grounded reasoning tasks without state overlap.
- **Distribution Prep:** Finalized build artifacts for the standardized P-Reinforce v3.0 knowledge base integration.

---

# Patch Notes - v2.36.0 (2026-05-02)

## 🏛️ Knowledge Ecosystem: P-Reinforce v3.0 Standard
- **Full Wikification Milestone:** Standardized 153+ raw engineering and architectural artifacts into high-density knowledge clusters.
- **Systemic Categorization:** Integrated automated classification for Process Methodology, Architecture Principles, Software Engineering, and DevOps.
- **Semantic Integrity:** Ensured 100% metadata consistency across the knowledge base, optimizing the agent's contextual grounding accuracy.

---

# Patch Notes - v2.35.1 (2026-05-02)

## 🎨 UI & UX Optimization
- **Second Brain Trace: Collapsible UI:** Integrated `<details>` blocks for Trace evidence to reduce visual noise while maintaining transparency.
- **Trace Summary:** Added a compact usage summary showing note counts and grounding status at a glance.
- **Improved Readability:** Optimized the layout of referenced notes and debug JSON within the expanded section.

---

# Patch Notes - v2.35.0 (2026-05-02)

## 🏛️ Milestone: Knowledge Resilience & Standardization
- **Authoritative Knowledge Base:** Completed the full synthesis of all raw engineering artifacts into the `10_Wiki` system, establishing a single source of truth for Cognitive Engineering, Agentic Coding, and Security Governance.
- **Zero-Ghost Integrity:** Finalized global graph cleanup, ensuring the Obsidian brain remains 100% free of broken nodes and fragmented stubs.
- **VSIX Distribution:** Optimized packaging for the new standardized environment, ensuring seamless integration with the latest knowledge clusters.

---

# Patch Notes - v2.34.1 (2026-05-02)

## 🧠 Knowledge Base Standardized (P-Reinforce v3.0)
- **High-Density Wikification:** Synthesized 148+ raw cognitive engineering and software maintenance artifacts into 9 authoritative, cross-linked clusters.
- **Graph Integrity Purge:** Executed global regex-based cleanup to eliminate all broken links (Ghost Nodes) and empty stubs, ensuring 100% structural reliability.
- **Topic Architecture:** Reorganized knowledge into standardized categories (Cognitive Engineering, AI/Agentic Coding, Security/Quality, etc.) for optimized discovery.

---

# Patch Notes - v2.33.9 (2026-05-01)

## 🚀 Core Engine Upgrade
- **Agent Workflow Optimization:** Enhanced `AgentWorkflowManager` and `AgentFactory` for more robust multi-agent orchestration.
- **Utility Refinement:** Core utilities and configuration logic updated for improved reliability and performance.
- **UI/UX Sync:** Further alignment between sidebar provider and core agent logic for a seamless experience.

---

# Patch Notes - v2.33.8 (2026-05-01)

## 🛠️ Performance & Stability
- **Agent Execution Refinement:** Further stabilized task orchestration and response validation.
- **Workflow Stabilization:** Minor internal logic updates to ensure consistent agent performance.

---

# Patch Notes - v2.33.7 (2026-05-01)

## ⚙️ Logic Refinement
- **Multi-Agent Routing:** Optimized workflow to prioritize local project analysis over general multi-agent execution when explicit projects are referenced.
- **Intent Detection:** Expanded analysis intent keywords for better project-level understanding triggers.
- **Error Handling:** Improved diagnostic details for empty AI responses to help troubleshoot local server issues.
- **Default Config:** Set `multiAgentEnabled` to `false` by default for a leaner initial experience.
- **UI Polish:** Enhanced Multi-Agent button UI with dynamic tooltips and state synchronization.

---

# Patch Notes - v2.33.6 (2026-05-01)

## 🛠️ Critical Bug Fixes
- **Chat Persistence Overhaul:** Resolved an issue where chat history disappeared after switching sidebar tabs.
- **Webview State Management:** Implemented `vscode.setState` for instant UI restoration.
- **Internal Message Logic:** Refined message filtering to ensure intermediate agent steps are visible to the user.

---

# Patch Notes - v2.33.5 (2026-05-01)

## 🎨 UI Refinement
- **Sidebar Provider Update:** Optimized sidebar rendering and event handling for smoother navigation.

---

# Patch Notes - v2.33.4 (2026-05-01)

## 🛠️ Manual Refinement & Stabilization
- **Core Agent Logic Update:** Manually refined `agent.ts` and `AgentWorkflowManager.ts` for improved task orchestration.
- **Workflow Factory Optimization:** Updated `factory.ts` to support more robust agent instantiation.
- **Configuration & UI Polish:** Fine-tuned `config.ts` and `sidebarProvider.ts` for a better user experience.

---

# 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*