@didim365/agent-cli-core 0.1.0 → 0.1.2

package/dist/docs/00_project/ai_adapter/utility-migration.md

@@ -1,237 +0,0 @@
-# 유틸리티/테스트 마이그레이션 계획
-
-> 📅 **작성일**: 2026-02-06  
-> 📚 **Phase**: Phase 1 - M1.4  
-> 🎯 **목표**: 유틸리티 레이어 및 테스트 마이그레이션 상세 계획 수립
-
----
-
-## 📊 분석 요약
-
-| 항목                 | 수량  | 비고                              |
-| -------------------- | :---: | --------------------------------- |
-| 유틸리티 파일        |  3개  | `@google/genai` 의존성 있음       |
-| 영향받는 테스트 파일 | 30+개 | Gemini 타입 직접 사용             |
-| 주요 의존 타입       |  6개  | Part, PartUnion, PartListUnion 등 |
-
----
-
-## 🔍 1. 유틸리티 파일 분석
-
-### 1.1 tokenCalculation.ts
-
-**파일**: `packages/core/src/utils/tokenCalculation.ts`
-
-**의존성**:
-
-```typescript
-import type { PartListUnion, Part } from '@google/genai';
-import type { ContentGenerator } from '../core/contentGenerator.js';
-```
-
-**핵심 함수**: | 함수 | 사용 타입 | 마이그레이션 복잡도 |
-|------|----------|:-------------------:| | `estimateTokenCountSync(parts)` |
-`Part[]` | ⭐⭐ 중간 | | `calculateRequestTokenCount(request, ...)` |
-`PartListUnion` | ⭐⭐⭐ 높음 |
-
-**마이그레이션 전략**:
-
-- `Part[]` → `LlmPart[]` (providers/types.ts)
-- `PartListUnion` → `LlmContent` 변환 유틸리티 추가
-
----
-
-### 1.2 partUtils.ts
-
-**파일**: `packages/core/src/utils/partUtils.ts`
-
-**의존성**:
-
-```typescript
-import type {
-  GenerateContentResponse,
-  PartListUnion,
-  Part,
-  PartUnion,
-} from '@google/genai';
-```
-
-**핵심 함수**: | 함수 | 사용 타입 | 마이그레이션 복잡도 |
-|------|----------|:-------------------:| | `partToString(value, options)` |
-`PartListUnion` | ⭐⭐ 중간 | | `getResponseText(response)` |
-`GenerateContentResponse` | ⭐⭐⭐ 높음 | | `flatMapTextParts(parts, transform)`
-| `PartListUnion`, `PartUnion[]` | ⭐⭐ 중간 | |
-`appendToLastTextPart(prompt, text, sep)` | `PartUnion[]` | ⭐⭐ 중간 |
-
-**마이그레이션 전략**:
-
-- `GenerateContentResponse` 접근 → `LlmResponse` 래퍼 사용
-- `PartUnion` → `LlmPart | string` 유니온으로 대체
-
----
-
-### 1.3 generateContentResponseUtilities.ts
-
-**파일**: `packages/core/src/utils/generateContentResponseUtilities.ts`
-
-**의존성**:
-
-```typescript
-import type {
-  GenerateContentResponse,
-  Part,
-  FunctionCall,
-  PartListUnion,
-} from '@google/genai';
-```
-
-**핵심 함수**: | 함수 | 사용 타입 | 마이그레이션 복잡도 |
-|------|----------|:-------------------:| | `convertToFunctionResponse(...)` |
-`Part`, `PartListUnion` | ⭐⭐⭐ 높음 | | `getFunctionCalls(response)` |
-`GenerateContentResponse`, `FunctionCall` | ⭐⭐⭐ 높음 | |
-`getStructuredResponse(response)` | `GenerateContentResponse` | ⭐⭐ 중간 | |
-`getCitations(resp)` | `GenerateContentResponse` | ⭐ 낮음 |
-
-**마이그레이션 전략**:
-
-- `FunctionCall` → `LlmToolCall` 매핑 필요
-- 응답 처리 유틸리티를 providers 레이어로 이동 고려
-
----
-
-## 📋 2. 테스트 파일 분석
-
-### 2.1 Gemini 전용 테스트 파일 목록 (30+개)
-
-**Core 영역** (16개):
-
-- `core/baseLlmClient.test.ts`
-- `core/client.test.ts`
-- `core/contentGenerator.test.ts`
-- `core/coreToolScheduler.test.ts`
-- `core/fakeContentGenerator.test.ts`
-- `core/geminiChat.test.ts`
-- `core/geminiChat_network_retry.test.ts`
-- `core/logger.test.ts`
-- `core/loggingContentGenerator.test.ts`
-- `core/recordingContentGenerator.test.ts`
-- `core/turn.test.ts`
-
-**Utils 영역** (4개):
-
-- `utils/partUtils.test.ts`
-- `utils/generateContentResponseUtilities.test.ts`
-- `utils/apiConversionUtils.test.ts`
-- `utils/nextSpeakerChecker.test.ts`
-
-**Services 영역** (4개):
-
-- `services/chatCompressionService.test.ts`
-- `services/loopDetectionService.test.ts`
-- `services/sessionSummaryService.test.ts`
-
-**기타** (6+개):
-
-- `hooks/hookTranslator.test.ts`
-- `hooks/types.test.ts`
-- `policy/policy-engine.test.ts`
-- `routing/strategies/*.test.ts`
-- `agents/*.test.ts`
-
-### 2.2 테스트 수정 범위 추정
-
-| 범위                 | 파일 수 | 예상 공수  |
-| -------------------- | :-----: | :--------: |
-| 타입 import 변경만   | 10~15개 |   ⭐ 1일   |
-| 모킹/픽스처 수정     | 10~12개 |  ⭐⭐ 2일  |
-| 테스트 로직 리팩터링 |  5~8개  | ⭐⭐⭐ 2일 |
-
----
-
-## 🎯 3. 마이그레이션 우선순위
-
-### Phase 2에서 처리 (높은 우선순위)
-
-| 우선순위 | 대상                                  | 이유                       |
-| :------: | ------------------------------------- | -------------------------- |
-|    1     | `tokenCalculation.ts`                 | 독립적, 영향 범위 작음     |
-|    2     | `partUtils.ts`                        | 널리 사용됨, 기반 유틸리티 |
-|    3     | `generateContentResponseUtilities.ts` | 복잡하지만 중요            |
-
-### Phase 3에서 처리 (낮은 우선순위)
-
-- 테스트 파일 마이그레이션
-- 모킹 인프라 정비
-
----
-
-## 🔧 4. 프로바이더 독립 유틸 설계
-
-### 4.1 신규 유틸리티 파일 구조
-
-```
-packages/core/src/providers/utils/
-├── contentUtils.ts     # LlmContent 유틸리티
-├── partUtils.ts        # LlmPart 유틸리티 (기존 래핑)
-└── tokenUtils.ts       # 토큰 계산 유틸리티
-```
-
-### 4.2 핵심 변환 함수
-
-```typescript
-// providers/utils/contentUtils.ts
-
-/** Gemini Part[] → LlmPart[] 변환 */
-export function toLlmParts(parts: Part[]): LlmPart[];
-
-/** LlmPart[] → Gemini Part[] 변환 */
-export function toGeminiParts(parts: LlmPart[]): Part[];
-
-/** LlmContent 텍스트 추출 */
-export function extractText(content: LlmContent): string;
-```
-
----
-
-## 📅 5. 마이그레이션 일정
-
-| 단계 | 작업                   | 예상 기간 |  Phase  |
-| :--: | ---------------------- | :-------: | :-----: |
-|  1   | 유틸리티 분석 완료     |   0.5일   | P1 M1.4 |
-|  2   | 테스트 분석 완료       |   0.5일   | P1 M1.4 |
-|  3   | 마이그레이션 문서화    |   0.5일   | P1 M1.4 |
-|  4   | providers/utils 생성   |    1일    |   P2    |
-|  5   | 유틸리티 파일 리팩터링 |    2일    |   P2    |
-|  6   | 테스트 마이그레이션    |    3일    |   P3    |
-
-**총 예상**: ~1.5일 (P1 M1.4) + 3일 (P2) + 3일 (P3)
-
----
-
-## ✅ 검증 기준
-
-- [ ] 모든 유틸리티 함수의 Gemini 의존성 식별
-- [ ] 프로바이더 독립 유틸리티 설계 완료
-- [ ] 테스트 마이그레이션 우선순위 정의
-- [ ] Phase 2/3 작업 범위 명확화
-
----
-
-## 📝 참고사항
-
-### 기존 타입 매핑
-
-| @google/genai             | providers/types.ts  |
-| ------------------------- | ------------------- |
-| `Part`                    | `LlmPart`           |
-| `PartUnion`               | `LlmPart \| string` |
-| `PartListUnion`           | `LlmContent`        |
-| `GenerateContentResponse` | `LlmResponse`       |
-| `FunctionCall`            | `LlmToolCall`       |
-| `Content`                 | `LlmMessage`        |
-
-### 주의사항
-
-1. **순환 의존성 방지**: providers → utils 방향 의존만 허용
-2. **점진적 마이그레이션**: 기존 API 유지하면서 새 API 추가
-3. **테스트 우선**: 마이그레이션 전 테스트 커버리지 확보

package/dist/docs/00_project/ai_adapter/working_history/Phase1_M1.0_/354/275/224/353/223/234/354/235/270/353/262/244/355/206/240/353/246/254_20260201.md

@@ -1,197 +0,0 @@
-# Phase 1 M1.0: 코드 인벤토리 및 영향도 분석 작업 기록
-
-**작업일**: 2026-02-01  
-**작업자**: AI Assistant  
-**브랜치**: DID/v0.1  
-**이전 작업**: 최초 작업  
-**관련 문서**:
-[00_master_implementation_plan.md](../todolist/00_master_implementation_plan.md) -
-Phase 1, M1.0
-
----
-
-## 📋 작업 개요
-
-### 목표
-
-- `@google/genai` 의존성 전체 인벤토리 작성
-- GeminiEventType 18개 이벤트 사용처 분석
-- 핵심 인터페이스 의존 관계 맵핑
-- 마이그레이션 전략 수립
-
-### 작업 범위
-
-- **파일 생성**:
-  - `docs/ai_adapter/migration-plan.md`: 마이그레이션 계획서
-  - `docs/ai_adapter/event-mapping-matrix.md`: 이벤트 매핑 매트릭스
-- **분석 대상**: packages/core/src 전체 코드베이스
-
----
-
-## 📊 분석 결과
-
-### @google/genai 의존 파일 현황 (총 101개)
-
-| 카테고리          | 파일 수 | 핵심 파일 (예시)                                                                       |
-| ----------------- | ------- | -------------------------------------------------------------------------------------- |
-| core/             | 21      | `turn.ts`, `contentGenerator.ts`, `geminiChat.ts`, `baseLlmClient.ts`, `client.ts` 등  |
-| utils/            | 20      | `partUtils.ts`, `tokenCalculation.ts`, `apiConversionUtils.ts` 등                      |
-| tools/            | 12      | `tool-registry.ts`, `mcp-client.ts`, `mcp-tool.ts`, `read-file.ts`, `web-search.ts` 등 |
-| services/         | 8       | `modelConfigService.ts`, `chatCompressionService.ts`, `loopDetectionService.ts` 등     |
-| hooks/            | 7       | `hookTranslator.ts`, `hookSystem.ts`, `hookEventHandler.ts`, `types.ts` 등             |
-| code_assist/      | 6       | `converter.ts`, `server.ts`, `telemetry.ts` 등                                         |
-| telemetry/        | 5       | `semantic.ts`, `types.ts` 등                                                           |
-| routing/          | 5       | `routingStrategy.ts`, `classifierStrategy.ts`, `numericalClassifierStrategy.ts` 등     |
-| agents/           | 5       | `local-executor.ts`, `codebase-investigator.ts`, `types.ts` 등                         |
-| policy/           | 3       | `policy-engine.ts` 등                                                                  |
-| safety/           | 3       | `checker-runner.ts`, `protocol.ts` 등                                                  |
-| config/           | 2       | `config.ts`, `defaultModelConfigs.ts`                                                  |
-| availability/     | 1       | `policyHelpers.ts`                                                                     |
-| scheduler/        | 1       | `types.ts`                                                                             |
-| commands/         | 1       | `types.ts`                                                                             |
-| confirmation-bus/ | 1       | `types.ts`                                                                             |
-| **합계**          | **101** | -                                                                                      |
-
-### GeminiEventType 분석 (18개)
-
-| #   | 이벤트                    | LlmStreamEventType 매핑 | 공통/특화       | 주요 사용처                      |
-| --- | ------------------------- | ----------------------- | --------------- | -------------------------------- |
-| 1   | Content                   | TextDelta               | 공통            | turn.ts, client.ts               |
-| 2   | ToolCallRequest           | ToolCallRequest         | 공통            | turn.ts, loopDetectionService.ts |
-| 3   | ToolCallResponse          | ToolCallResponse        | 공통            | turn.ts                          |
-| 4   | ToolCallConfirmation      | ToolCallConfirmation    | 공통            | turn.ts                          |
-| 5   | UserCancelled             | UserCancelled           | 공통            | turn.ts, client.ts               |
-| 6   | Error                     | Error                   | 공통            | turn.ts, client.ts               |
-| 7   | ChatCompressed            | ChatCompressed          | **Gemini 특화** | client.ts                        |
-| 8   | Thought                   | ThoughtDelta            | 공통            | turn.ts (Claude 호환)            |
-| 9   | MaxSessionTurns           | MaxSessionTurns         | 공통            | client.ts                        |
-| 10  | Finished                  | Finished                | 공통            | turn.ts                          |
-| 11  | LoopDetected              | LoopDetected            | 공통            | client.ts                        |
-| 12  | Citation                  | Citation                | **Gemini 특화** | turn.ts                          |
-| 13  | Retry                     | Retry                   | 공통            | turn.ts, client.ts               |
-| 14  | ContextWindowWillOverflow | ContextWindowOverflow   | 공통            | client.ts                        |
-| 15  | InvalidStream             | InvalidStream           | 공통            | turn.ts                          |
-| 16  | ModelInfo                 | ModelInfo               | 공통            | client.ts                        |
-| 17  | AgentExecutionStopped     | AgentStopped            | 공통            | turn.ts, client.ts               |
-| 18  | AgentExecutionBlocked     | AgentBlocked            | 공통            | turn.ts, client.ts               |
-
-### Critical Path 파일
-
-**Tier 1 (최우선 - @google/genai 직접 결합)**:
-
-- `core/turn.ts` - GeminiEventType 정의
-- `core/contentGenerator.ts` - ContentGenerator 인터페이스, AuthType
-- `core/geminiChat.ts` - 스트리밍 로직 (988라인)
-- `core/baseLlmClient.ts` - Content, Part, GenerateContentConfig
-- `core/client.ts` - GeminiClient, 세션 관리
-
-**Tier 2 (연쇄 영향 - 핵심 서비스)**:
-
-- `core/loggingContentGenerator.ts` - 텔레메트리 래퍼
-- `core/recordingContentGenerator.ts` - 녹화/재생
-- `core/fakeContentGenerator.ts` - 테스트용
-- `services/modelConfigService.ts` - GenerateContentConfig 의존
-- `routing/routingStrategy.ts` - @google/genai 타입 직접 import
-
-**Tier 3 (확장 영향 - 에이전트/도구)**:
-
-- `agents/local-executor.ts` - StreamEventType 사용
-- `telemetry/*` - usageMetadata, GenerateContentConfig
-- `tools/*` - FunctionDeclaration, Part
-- `scheduler/types.ts` - FunctionCall
-- `policy/policy-engine.ts` - Part 타입
-- `safety/*` - Part, Content 타입
-
----
-
-## ✅ 검증 결과
-
-### 분석 완료 항목
-
-- 완료: 18/18 항목
-
-### 생성 문서
-
-- `migration-plan.md`: 마이그레이션 계획 완성
-- `event-mapping-matrix.md`: 18개 이벤트 매핑 완성
-
----
-
-## 🐛 이슈 및 해결
-
-### 이슈 1: 라우팅 레이어 @google/genai 직접 import
-
-- **증상**: `routingStrategy.ts`에서 Content, PartListUnion 직접 참조
-- **영향**: M2.6에서 별도 마일스톤으로 처리 필요
-- **대응**: Critical Issue로 등록 완료
-
-### 이슈 2: 테스트 파일 의존성
-
-- **증상**: 테스트 파일에서도 @google/genai mock 객체 광범위 사용
-- **영향**: M3.5 테스트 마이그레이션 작업량 증가 예상
-- **대응**: Phase 3 일정에 반영 필요
-
-### 이슈 3: 예상보다 넓은 영향 범위
-
-- **증상**: 초기 분석(63개)보다 실제 의존 파일(100개)이 더 많음
-- **영향**: 마이그레이션 일정 재검토 필요
-- **대응**: Phase 2/3 일정 버퍼 확보 권장
-
----
-
-## 📝 다음 단계
-
-- [/] 다음 Step: M1.1 타입/에러/호환 레이어 설계
-- [ ] 후속 작업: providers/types.ts 신규 타입 정의 시작
-
----
-
-## 📊 커밋 요약
-
-| 순서 | 커밋 ID     | 타입 | 설명                | 테스트 |
-| ---- | ----------- | ---- | ------------------- | ------ |
-| 1    | `396546ffb` | DOCS | M1.0 분석 문서 작성 | N/A    |
-| 2    | `158ea5a66` | DOCS | 리뷰 반영 수정      | N/A    |
-
-**총 커밋 수**: 2개
-
----
-
-## ✅ 완료 기준 체크
-
-- [x] @google/genai 의존 파일 전체 스캔 (**101개**)
-- [x] GeminiEventType 18개 이벤트 분석 (전체 사용처 포함)
-- [x] ContentGenerator 의존 분석
-- [x] ModelConfigService 종속성 분석
-- [x] migration-plan.md 작성
-- [x] event-mapping-matrix.md 작성
-
----
-
-## 📌 다음 작업 전달 이슈
-
-| ID  | 이슈                                               | 우선순위 | 담당 마일스톤 |
-| --- | -------------------------------------------------- | -------- | ------------- |
-| I-1 | routingStrategy.ts @google/genai 직접 참조         | Critical | M2.6          |
-| I-2 | 테스트 파일 mock 객체 마이그레이션 규모            | High     | M3.5          |
-| I-3 | ChatCompressed, Citation은 Gemini 특화 이벤트      | Medium   | M1.2          |
-| I-4 | 의존 파일 101개로 예상보다 **60.3% 증가** (63→101) | High     | Phase 2/3     |
-
----
-
-## 📋 리뷰 반영 이력
-
-| 일시             | 리뷰 항목                          | 수정 내용                                 |
-| ---------------- | ---------------------------------- | ----------------------------------------- |
-| 2026-02-01 22:49 | [Critical] 파일 수 과소 보고       | 63개 → 100개로 정정                       |
-| 2026-02-01 22:49 | [High] GeminiEventType 분석 불완전 | 18개 전체 이벤트 테이블 추가              |
-| 2026-02-01 22:49 | [High] Critical Path 누락          | Tier 3 추가 (agents, telemetry, tools 등) |
-| 2026-02-01 22:49 | [Medium] 카테고리별 파일 수 오차   | 정확한 수치로 정정                        |
-| 2026-02-01 22:49 | [Low] 작업 범위 문구               | "문서 수정없이" → "분석 대상"으로 정정    |
-
----
-
-**작업 완료 시간**: 2026-02-01 22:30  
-**리뷰 반영 시간**: 2026-02-01 22:49  
-**작업 소요 시간**: 약 20분 + 리뷰 반영 10분  
-**최종 상태**: ✅ 완료 (리뷰 반영)

package/dist/docs/00_project/ai_adapter/working_history/Phase1_M1.1_/355/203/200/354/236/205/354/204/244/352/263/204_20260201.md

@@ -1,185 +0,0 @@
-# Phase 1, Milestone 1.1: 타입/에러/호환 레이어 설계 - 작업 결과서
-
-- **작업일**: 2026-02-01
-- **상태**: ✅ 완료
-- **커밋**: `b6668553c`
-
----
-
-## 📋 작업 개요
-
-프로바이더 독립 타입 시스템을 구현하여 Gemini, Claude, OpenAI, vLLM 등 다양한
-LLM 프로바이더를 지원하기 위한 기반을 마련.
-
----
-
-## 📊 작업 결과
-
-### 새 파일 (6개, 1528줄)
-
-| 파일               | 라인 | 설명                                                              |
-| ------------------ | ---- | ----------------------------------------------------------------- |
-| `types.ts`         | ~280 | 핵심 타입: LlmMessage, LlmContent, LlmGenerateRequest/Response 등 |
-| `events.ts`        | ~340 | 스트림 이벤트: LlmEventType (18개), 이벤트 페이로드, 타입 가드    |
-| `errors.ts`        | ~310 | 에러 타입: LlmError, LlmErrorType, 서브클래스 9개                 |
-| `legacyAliases.ts` | ~170 | 레거시 호환: Content→LlmMessage, Part→LlmContent 등               |
-| `index.ts`         | ~30  | 모듈 re-export                                                    |
-| `types.test.ts`    | ~264 | 테스트 19개                                                       |
-
-### 핵심 타입 정의
-
-```typescript
-// LlmContent 유니온 타입 (5가지)
-LlmTextContent |
-  LlmImageContent |
-  LlmToolCallContent |
-  LlmToolResultContent |
-  LlmThoughtContent;
-
-// LlmMessage 구조
-interface LlmMessage {
-  role: 'user' | 'assistant' | 'system' | 'tool';
-  content: LlmContent[];
-  name?: string;
-  toolCallId?: string;
-}
-
-// LlmEventType (GeminiEventType 18개 매핑)
-(TextDelta,
-  ThoughtDelta,
-  ToolCallRequest,
-  ToolCallResponse,
-  ToolCallConfirmation,
-  Finished,
-  MessageEnd,
-  Error,
-  UserCancelled,
-  Retry,
-  InvalidStream,
-  ContextWindowOverflow,
-  MaxSessionTurns,
-  ChatCompressed,
-  LoopDetected,
-  AgentStopped,
-  AgentBlocked,
-  ModelInfo,
-  Citation);
-```
-
----
-
-## ✅ 검증 결과
-
-| 항목       | 결과          |
-| ---------- | ------------- |
-| **빌드**   | ✅ 성공       |
-| **테스트** | ✅ 19/19 통과 |
-| **린트**   | ✅ 통과       |
-
----
-
-## 🔄 GeminiEventType → LlmEventType 매핑
-
-| GeminiEventType           | LlmEventType          | 유형       |
-| ------------------------- | --------------------- | ---------- |
-| Content                   | TextDelta             | 공통       |
-| Thought                   | ThoughtDelta          | 공통       |
-| ToolCallRequest           | ToolCallRequest       | 공통       |
-| ToolCallResponse          | ToolCallResponse      | 공통       |
-| ToolCallConfirmation      | ToolCallConfirmation  | 공통       |
-| Finished                  | Finished              | 공통       |
-| Error                     | Error                 | 공통       |
-| UserCancelled             | UserCancelled         | 공통       |
-| Retry                     | Retry                 | 공통       |
-| InvalidStream             | InvalidStream         | 공통       |
-| ContextWindowWillOverflow | ContextWindowOverflow | 공통       |
-| MaxSessionTurns           | MaxSessionTurns       | 공통       |
-| LoopDetected              | LoopDetected          | 공통       |
-| AgentExecutionStopped     | AgentStopped          | 공통       |
-| AgentExecutionBlocked     | AgentBlocked          | 공통       |
-| ModelInfo                 | ModelInfo             | 공통       |
-| ChatCompressed            | ChatCompressed        | Gemini특화 |
-| Citation                  | Citation              | Gemini특화 |
-
----
-
-## 📝 다음 작업 (M1.2)에 전달할 이슈
-
-| ID  | 이슈                                               | 우선순위 |
-| --- | -------------------------------------------------- | -------- |
-| I-5 | BaseAdapter 추상 클래스 구현 필요                  | High     |
-| I-6 | GeminiAdapter는 GeminiTypeConverter와 함께 구현    | High     |
-| I-7 | ContentGenerator 인터페이스 재정의 (types.ts 참조) | High     |
-
----
-
-## 📁 파일 위치
-
-```
-packages/core/src/providers/
-├── index.ts           # 모듈 re-export
-├── types.ts           # 핵심 타입 정의
-├── types.test.ts      # 타입 테스트
-├── events.ts          # 스트림 이벤트 타입
-├── errors.ts          # 에러 타입
-└── legacyAliases.ts   # 레거시 호환 Alias
-```
-
----
-
-**작성**: AI Assistant  
-**완료**: 2026-02-01 23:15 KST
-
----
-
-## 📝 리뷰 피드백 반영 (2026-02-01 23:25)
-
-### 수정된 이슈
-
-| 심각도       | 이슈                       | 수정 내용                                                                                                  |
-| ------------ | -------------------------- | ---------------------------------------------------------------------------------------------------------- |
-| **Critical** | 스트림 이벤트 2중 정의     | `types.ts`에서 `LlmStreamEventType` 제거, 간소화된 `LlmStreamEvent` 유지. 상세 이벤트는 `events.ts`로 통합 |
-| **High**     | 이벤트 개수 불일치 (18→19) | `events.ts` 문서 주석 수정: "18 events + MessageEnd = 19 total"                                            |
-| **High**     | 이미지 URL 필드 구조       | `LlmImageSource` 유니온 타입 도입: base64는 `data`, url은 `url` 필드 사용                                  |
-| **Medium**   | `usage` 필수               | `LlmGenerateResponse.usage`를 선택적(`?`)으로 변경                                                         |
-| **Medium**   | 툴 결과 타입 제한          | `content: string \| Record<string, unknown>`으로 확장                                                      |
-| **Medium**   | Legacy alias 구조 경고     | `Content`, `PartListUnion`에 WARNING 주석 추가                                                             |
-
-### 추후 과제
-
-| 심각도  | 이슈                      | 상태               |
-| ------- | ------------------------- | ------------------ |
-| **Low** | events/errors 테스트 부재 | M1.2에서 추가 예정 |
-
-### 검증 결과
-
-- **빌드**: ✅ 성공
-- **테스트**: ✅ 20/20 통과 (1개 추가됨)
-
----
-
-## 📝 2차 리뷰 피드백 반영 (2026-02-02 00:45)
-
-### 이슈 검증 결과
-
-| ID  | 심각도   | 이슈                        | 결과                                                                          |
-| --- | -------- | --------------------------- | ----------------------------------------------------------------------------- |
-| C-1 | Critical | 누락된 문서 참조            | ❌ False Positive: `event-mapping-matrix.md`, `migration-plan.md` 모두 존재함 |
-| H-1 | High     | LlmImageSource 설계 불일치  | ✅ 설계문서 업데이트: base64는 `data`, url은 `url` 필드                       |
-| H-2 | High     | MODEL_OVERLOADED 누락       | ✅ `errors.ts`에 추가                                                         |
-| H-3 | High     | GeminiEventType 매핑        | ✅ 검증 완료: 18개 이벤트 정확히 매핑됨                                       |
-| M-1 | Medium   | content_delta vs text_delta | ✅ `text_delta`로 통일                                                        |
-| M-2 | Medium   | events/errors 테스트 부재   | 🔄 M1.2에서 추가 예정                                                         |
-| M-3 | Medium   | LlmEmbedRequest 미정의      | ✅ TODO 주석 추가                                                             |
-| L-1 | Low      | supportsThought 설계 반영   | 🔄 추후 설계문서 업데이트 예정                                                |
-
-### 수정된 파일
-
-- `errors.ts`: MODEL_OVERLOADED 에러 타입 추가
-- `types.ts`: content_delta → text_delta, Embed TODO 추가
-- `03-technical-design.md`: LlmImageSource, LlmToolResultContent 업데이트
-
-### 검증 결과
-
-- **빌드**: ✅ 성공
-- **테스트**: ✅ 20/20 통과