@didim365/agent-cli-core 0.1.0

package/dist/docs/00_project/ai_adapter/working_history/Phase1_M1.4_/354/234/240/355/213/270/353/246/254/355/213/260/353/247/210/354/235/264/352/267/270/353/240/210/354/235/264/354/205/230_20260206.md

@@ -0,0 +1,86 @@
+# Phase 1 M1.4 유틸리티/테스트 마이그레이션 계획 작업 결과
+
+> 📅 **작업일**: 2026-02-06  
+> 🎯 **목표**: 유틸리티 레이어 및 테스트 마이그레이션 상세 계획 수립
+
+---
+
+## 📊 진행 현황
+
+| 구성요소                       |  상태   | 비고                 |
+| ------------------------------ | :-----: | -------------------- |
+| 1.4.1 유틸리티 레이어 분석     | ✅ 완료 | 3개 파일, 6개 타입   |
+| 1.4.2 테스트 파일 분석         | ✅ 완료 | 30+ 파일             |
+| 1.4.3 마이그레이션 계획 문서화 | ✅ 완료 | utility-migration.md |
+
+---
+
+## 🔍 1.4.1 유틸리티 레이어 분석
+
+### 분석 대상 파일
+
+| 파일                                  | @google/genai 타입                                                 | 마이그레이션 복잡도 |
+| ------------------------------------- | ------------------------------------------------------------------ | :-----------------: |
+| `tokenCalculation.ts`                 | `Part`, `PartListUnion`                                            |      ⭐⭐ 중간      |
+| `partUtils.ts`                        | `GenerateContentResponse`, `Part`, `PartUnion`, `PartListUnion`    |     ⭐⭐⭐ 높음     |
+| `generateContentResponseUtilities.ts` | `GenerateContentResponse`, `Part`, `FunctionCall`, `PartListUnion` |     ⭐⭐⭐ 높음     |
+
+### 의존성 요약
+
+```
+@google/genai 타입:
+├── Part (3개 파일)
+├── PartListUnion (3개 파일)
+├── PartUnion (1개 파일)
+├── GenerateContentResponse (2개 파일)
+└── FunctionCall (1개 파일)
+```
+
+---
+
+## 📋 1.4.2 테스트 파일 분석
+
+### Gemini 전용 테스트 파일 (30+개)
+
+| 영역                                  | 파일 수 | 예상 수정 범위            |
+| ------------------------------------- | :-----: | ------------------------- |
+| Core                                  |  11개   | 모킹/픽스처 전면 수정     |
+| Utils                                 |   4개   | 타입 import + 테스트 로직 |
+| Services                              |   4개   | 타입 import + 모킹        |
+| 기타 (hooks, policy, routing, agents) |  11+개  | 타입 import 위주          |
+
+### 수정 범위 추정
+
+- **타입 import 변경만**: 10~15개 (1일)
+- **모킹/픽스처 수정**: 10~12개 (2일)
+- **테스트 로직 리팩터링**: 5~8개 (2일)
+
+---
+
+## 📄 1.4.3 마이그레이션 계획 문서화
+
+### 산출물
+
+[utility-migration.md](file:///Users/junghojang/Developments/didimProject/gemini-cli/docs/ai_adapter/utility-migration.md)
+
+### 주요 내용
+
+1. **유틸리티 파일별 의존성 분석**
+2. **프로바이더 독립 유틸리티 설계** (`providers/utils/`)
+3. **마이그레이션 우선순위 정의**
+4. **일정 수립**: P1 1.5일 + P2 3일 + P3 3일
+
+---
+
+## ✅ 검증 기준 체크리스트
+
+- [x] 모든 유틸리티 함수의 Gemini 의존성 식별
+- [x] 프로바이더 독립 유틸리티 설계 완료
+- [x] 테스트 마이그레이션 우선순위 정의
+- [x] Phase 2/3 작업 범위 명확화
+
+---
+
+## 🚀 다음 작업
+
+**M1.4 완료** → Phase 1 Completion Checklist 확인 및 Phase 2 준비

package/dist/docs/00_project/ai_adapter/working_history/Phase2_ETC_/354/227/260/352/270/260/354/236/221/354/227/205/354/240/225/353/246/254_20260208.md

@@ -0,0 +1,157 @@
+# Phase 2: ETC 연기 작업 정리 및 Phase 2 클로저 작업 결과서
+
+> 📅 **작업일**: 2026-02-08 📚 **Phase**: Phase 2 - ETC (클로저 마일스톤) 🎯
+> **목표**: Phase 2에서 연기된 작업들의 체계적 정리, Phase 3 핸드오프 문서 작성
+> 🔗 **이전 작업**:
+> [Phase2*M2.6*라우팅레이어타입독립화\_20260208.md](./Phase2_M2.6_라우팅레이어타입독립화_20260208.md)
+> 🔗 **관련 문서**:
+> [phase2_core_refactoring_todolist.md](../todolist/phase2_core_refactoring_todolist.md),
+> [phase3_handoff.md](../todolist/phase3_handoff.md)
+
+---
+
+## 📋 작업 요약
+
+### 접근 전략
+
+**클로저 마일스톤**: Phase 2 ETC는 코드 변경이 아닌 문서 정리 마일스톤.
+M2.0~M2.6의 모든 작업 결과서에서 연기된 항목을 수집하고, 이를 "이미 해결됨(A)"
+vs "Phase 3 범위(B)"로 분류하여 todolist 정합성을 확보.
+
+**작업 순서**: 연기 항목 전수 조사 → 분류 (A/B) → todolist 상태 업데이트 →
+Quality Gate 기록 → Phase 3 핸드오프 문서 작성
+
+---
+
+## ✅ 변경 사항
+
+### ETC-1: Todolist 상태 정합성 업데이트
+
+**A그룹 — 이미 해결됨 (⏸️/⬜ → ✅)**
+
+| 항목                                             | 원래 상태 | 해결 경위                                 |
+| ------------------------------------------------ | --------- | ----------------------------------------- |
+| 2.0.2.1 `core/turn.ts` 공통 인터페이스 추출      | ⏸️        | re-export 패턴으로 대체 완료 (M2.0)       |
+| 2.1.2.3 `ProviderFactory` 연동                   | ⏸️        | M2.3 adapterBridge 패턴으로 해결          |
+| 2.1.2.5 기능 플래그 분기 추가                    | ⏸️        | M2.3 featureFlag.ts 통합 완료 (a5a81c60e) |
+| 2.4.2.1~3 라우팅 컨텍스트/프로바이더 인식/호환성 | ⏸️        | M2.6 타입 독립화 완료                     |
+
+**B그룹 — Phase 3 범위 (비고에 "→ Phase 3" 명시)**
+
+| 항목                                   | 사유                              |
+| -------------------------------------- | --------------------------------- |
+| 2.3.1.8 AuthType 처리 통합             | 비-Gemini 프로바이더 추가 시 필요 |
+| chat.ts/turn.ts 물리적 이동            | 병행 경로 전략                    |
+| messageInspectors 마이그레이션 (4파일) | Content 타입 기반 사용처          |
+| client.ts GeminiEventType 참조 (17곳)  | 대규모 동작 변경                  |
+| 검증기준 미체크 항목들                 | 런타임/E2E 검증 필요              |
+
+### ETC-2: Quality Gate 증거 기록
+
+```
+ Test Files  260 passed (260)
+      Tests  4829 passed | 24 skipped (4853)
+ TypeCheck   All workspaces passed
+ Lint        0 errors, 0 warnings
+```
+
+### ETC-3: Phase 3 핸드오프 문서
+
+- **파일**: `docs/ai_adapter/todolist/phase3_handoff.md` (신규)
+- **내용**: 연기 항목 11건 카탈로그 (Critical 4 / High 3 / Medium 4),
+  messageInspectors 상세, 잔여 @google/genai 현황 (116개), 레슨 6건, Phase 3
+  권장 작업 순서
+
+---
+
+## 📁 변경 파일 목록
+
+### 문서 파일 (3개)
+
+| 파일                                                                  | 변경 유형                       |
+| --------------------------------------------------------------------- | ------------------------------- |
+| `docs/ai_adapter/todolist/phase2_core_refactoring_todolist.md`        | Modified — 상태 정합성 업데이트 |
+| `docs/ai_adapter/todolist/phase3_handoff.md`                          | **New** — Phase 3 핸드오프 문서 |
+| `docs/ai_adapter/working_history/Phase2_ETC_연기작업정리_20260208.md` | **New** — 본 작업 결과서        |
+
+---
+
+## 🔑 검증 기준 충족 확인
+
+| 검증 기준                                                         | 결과 |
+| ----------------------------------------------------------------- | :--: |
+| Todolist 내 모든 ⏸️/⬜ 항목이 A(✅) 또는 B(Phase 3 명시)로 분류됨 |  ✅  |
+| Quality Gate 결과 (테스트/타입체크/린트) 기록 완료                |  ✅  |
+| Phase 3 핸드오프 문서에 모든 연기 항목 포함                       |  ✅  |
+| 코드 변경 없음 (문서 전용 마일스톤)                               |  ✅  |
+
+---
+
+## 📝 Phase 2 전체 마일스톤 현황
+
+| 마일스톤                         | 상태 | 작업일        |
+| -------------------------------- | :--: | ------------- |
+| M2.0 디렉토리 재구성             |  ✅  | 2026-02-07    |
+| M2.1 ContentGenerator 타입 전환  |  ✅  | 2026-02-07    |
+| M2.2 EventMapper/StreamAssembler |  ✅  | 2026-02-07~08 |
+| M2.3 GeminiAdapter 구현          |  ✅  | 2026-02-08    |
+| M2.4 ModelConfigService 호환     |  ✅  | 2026-02-08    |
+| M2.5 유틸리티 리팩토링           |  ✅  | 2026-02-08    |
+| M2.6 라우팅 타입 독립화          |  ✅  | 2026-02-08    |
+| ETC 연기 작업 정리               |  ✅  | 2026-02-08    |
+
+**Phase 2 완료**. Phase 3 진입 준비 완료.
+
+---
+
+## 🔧 리뷰 수정 사항
+
+### 이슈 1 (Medium): ModelConfigBridge provider-aware 키 미적용
+
+- **위치**: `src/services/modelConfigBridge.ts:74,172`
+- **문제**: `registerLlmConfig()`이 model-only 키를 사용하여, 동일 모델명을 다중
+  provider에서 사용 시 설정이 덮어쓰여 라우팅/설정 불일치 위험
+- **수정**: `provider:model` 복합 키 도입
+  - `registerLlmConfig()`: `config.provider`로 `provider:name` 키 생성
+  - `resolveNonGemini()`: `provider:model` → `model` 순서로 폴백 조회
+- **회귀 테스트**:
+  - `should isolate configs when same model name registered under different providers`
+  - `should not return wrong provider config for provider mismatch`
+
+### 이슈 2 (Medium): GeminiAdapter.generateContentStream() 에러 미정규화
+
+- **위치**: `src/providers/gemini/adapter.ts:117-127`
+- **문제**: 스트림 생성/순회 예외가 `handleError()` 없이 그대로 전파되어
+  멀티프로바이더 공통 에러 처리 일관성 파괴
+- **수정**: `streamGenerator()` 내부에 try-catch 추가, `handleError()`로
+  `LlmError` 정규화
+- **회귀 테스트**:
+  - `should normalize stream creation errors to LlmError`
+  - `should normalize stream iteration errors to LlmError`
+
+### 이슈 3 (Low): MaxListenersExceededWarning — 시그널 핸들러 누수
+
+- **위치**: `src/telemetry/sdk.ts:317,321`
+- **문제**: `process.on('SIGTERM')`/`process.on('SIGINT')` 핸들러가
+  `shutdownTelemetry()`에서 제거되지 않아 재초기화 시 누적
+- **판정**: Phase 2 ETC 범위가 아닌 기존 프로젝트 코드 — Phase 3 핸드오프에 기록
+- **조치**: `phase3_handoff.md`에 #12 항목으로 추가
+
+### Quality Gate (수정 후)
+
+```
+ Test Files  260 passed (260)
+      Tests  4833 passed | 24 skipped (4857)
+ TypeCheck   All workspaces passed
+ Lint        0 errors, 0 warnings
+```
+
+### 변경 파일 (리뷰 수정)
+
+| 파일                                         | 변경 유형                           |
+| -------------------------------------------- | ----------------------------------- |
+| `src/services/modelConfigBridge.ts`          | Modified — provider-aware 키        |
+| `src/services/modelConfigBridge.test.ts`     | Modified — provider 충돌 테스트 2건 |
+| `src/providers/gemini/adapter.ts`            | Modified — stream 에러 정규화       |
+| `src/providers/gemini/geminiAdapter.test.ts` | Modified — stream 에러 테스트 2건   |
+| `docs/ai_adapter/todolist/phase3_handoff.md` | Modified — 리스너 누수 항목 추가    |

package/dist/docs/00_project/ai_adapter/working_history/Phase2_M2.0_/353/224/224/353/240/211/355/206/240/353/246/254/354/236/254/352/265/254/354/204/261_20260207.md

@@ -0,0 +1,107 @@
+# Phase 2: M2.0 디렉토리 재구성 작업 결과서
+
+> 📅 **작업일**: 2026-02-07  
+> 📚 **Phase**: Phase 2 - M2.0: Directory Restructuring (Tidy First)  
+> 🎯 **목표**: Gemini 전용 타입들을 `providers/gemini/` 디렉토리로 분리
+
+---
+
+## 📋 작업 요약
+
+### 완료된 작업
+
+| 항목                              | 상태 | 비고                               |
+| --------------------------------- | :--: | ---------------------------------- |
+| `providers/gemini/` 디렉토리 생성 |  ✅  | 새 디렉토리 구조 생성              |
+| `providers/gemini/types.ts` 생성  |  ✅  | GeminiEventType + 18개 이벤트 타입 |
+| `providers/gemini/index.ts` 생성  |  ✅  | 모듈 인덱스                        |
+| `core/turn.ts` re-export 추가     |  ✅  | 하위 호환성 100% 유지              |
+| 테스트 검증                       |  ✅  | 95개 테스트 통과                   |
+
+### 보류된 작업
+
+- **geminiChat.ts 이동**: 988라인 대규모 파일로 M2.2에서 스트리밍 분해와 함께
+  처리 예정
+
+---
+
+## 📁 파일 변경 사항
+
+### 신규 파일
+
+```
+packages/core/src/providers/gemini/
+├── index.ts      # 모듈 인덱스 (re-export)
+└── types.ts      # GeminiEventType, 이벤트 타입들, CompressionStatus 등
+```
+
+### 수정 파일
+
+| 파일           | 변경 내용                                                 |
+| -------------- | --------------------------------------------------------- |
+| `core/turn.ts` | 타입 정의 제거, `providers/gemini/types.ts`에서 re-export |
+
+---
+
+## ✅ 테스트 결과
+
+```
+✓ src/core/turn.test.ts                    (22 tests)
+✓ src/services/loopDetectionService.test.ts (47 tests)
+✓ src/services/chatCompressionService.test.ts (26 tests)
+
+Total: 95 passed (95)
+```
+
+---
+
+## 📝 다음 작업 (M2.1)
+
+### 이어서 진행할 작업
+
+- M2.1: Provider 인터페이스 정의
+- M2.2: GeminiChat 스트리밍 분해 및 이동
+
+### Open Questions
+
+없음
+
+---
+
+## 🔖 커밋 정보
+
+> 커밋 전 상태 - 사용자 검토 후 커밋 예정
+
+**예정 커밋 메시지:**
+
+```
+refactor(providers): move Gemini types to providers/gemini/types.ts [STRUCTURAL]
+```
+
+---
+
+## 🔄 리뷰 피드백 반영
+
+### Findings 해결
+
+| 이슈                                          | 해결 방법                      |
+| --------------------------------------------- | ------------------------------ |
+| gemini barrel이 providers/index.ts에서 미노출 | `Gemini` namespace export 추가 |
+| 미사용 barrel stub                            | namespace export로 활용됨      |
+
+### Open Questions 답변
+
+1. **providers/index.ts에서 gemini 노출 여부**: ✅ namespace export
+   (`export { Gemini }`)로 추가
+2. **export surface 테스트 필요 여부**: ✅ `exports.test.ts` 추가 (7개 테스트)
+
+### 사용 예시
+
+```typescript
+// Namespace import (권장)
+import { Gemini } from '@google/gemini-cli-core/providers';
+Gemini.GeminiEventType.Content;
+
+// Direct import (가능)
+import { GeminiEventType } from '@google/gemini-cli-core/providers/gemini';
+```