@didim365/agent-cli-core 0.1.0

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

@@ -0,0 +1,237 @@
+# 유틸리티/테스트 마이그레이션 계획
+
+> 📅 **작성일**: 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

@@ -0,0 +1,197 @@
+# 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

@@ -0,0 +1,185 @@
+# 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 통과