@didim365/agent-cli-core 0.1.0 → 0.1.2

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

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

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

@@ -1,107 +0,0 @@
-# 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';
-```