@didim365/agent-cli-core 0.1.1 → 0.1.2

package/dist/docs/00_project/ai_adapter/working_history/Phase3_M3.0.3_/355/205/224/353/240/210/353/251/224/355/212/270/353/246/254Agent/353/217/205/353/246/275/355/231/224_20260209.md

@@ -1,251 +0,0 @@
-# M3.0.3 작업 결과서 — 텔레메트리/Agent 레이어 독립화
-
-- **작업일**: 2026-02-09
-- **브랜치**: `DID/v0.1`
-- **상태**: ✅ 완료
-
-## 작업 목표
-
-텔레메트리 및 Agent 레이어에서 `@google/genai` SDK 직접 의존성을 제거하여
-프로바이더 독립적 구조를 확보한다.
-
-## 작업 순서 및 결과
-
-| 순서 | Sub-task | 작업 내용                                                                    | 테스트 결과           |
-| ---- | -------- | ---------------------------------------------------------------------------- | --------------------- |
-| 1    | 3.0.3.5  | `sdk.ts` SIGTERM/SIGINT 핸들러 누수 수정                                     | 20/20 PASS (신규 4건) |
-| 2    | 3.0.3.4  | `types.ts` `GenerateContentResponseUsageMetadata` → `TelemetryUsageMetadata` | 36/36 PASS            |
-| 3    | 3.0.3.2  | `semantic.ts` Part/Content/Candidate/FinishReason 독립화 (7 types + enum)    | 21/21 PASS            |
-| 4    | 3.0.3.1  | `loggingContentGenerator.ts` + `types.ts` @google/genai import 완전 제거     | 11/11 + 36/36 PASS    |
-| 5    | 3.0.3.3  | `LocalAgentExecutor` AgentChatSession 인터페이스 + factory 패턴 도입 (Q5)    | 38/38 + 26/26 PASS    |
-
-## 변경 파일 상세
-
-### 3.0.3.5: Signal Handler Leak Fix
-
-**파일**: `telemetry/sdk.ts`, `telemetry/sdk.test.ts`
-
-- `initializeTelemetry()`에서 등록한 SIGTERM/SIGINT 핸들러를 named reference로
-  변경
-- `shutdownTelemetry()` finally 블록에서 `process.removeListener()` 호출
-- 핸들러 누적 방지: MaxListenersExceededWarning 경고 해소
-- **[리뷰 반영]** 시그널 핸들러 등록을 `sdk.start()` 성공 후(try 블록 내부)로
-  이동하여, start 실패 시 핸들러 미등록 보장 (신규 테스트 1건 추가)
-
-### 3.0.3.4: TelemetryUsageMetadata 독립화
-
-**파일**: `telemetry/types.ts`
-
-- `GenerateContentResponseUsageMetadata` SDK import → 로컬
-  `TelemetryUsageMetadata` 인터페이스
-- 필드: `promptTokenCount`, `candidatesTokenCount`, `cachedContentTokenCount`,
-  `thoughtsTokenCount`, `toolUsePromptTokenCount`, `totalTokenCount`
-- TypeScript structural typing으로 SDK 객체 호환 유지
-
-### 3.0.3.2: semantic.ts 타입 독립화
-
-**파일**: `telemetry/semantic.ts`
-
-- `@google/genai` import 완전 제거 (runtime + type 모두)
-- 6개 로컬 타입 정의:
-  - `TelemetryPart` — toOTelPart()에서 사용하는 필드만 포함
-  - `TelemetryContent` — parts + role
-  - `TelemetryContentUnion` — systemInstruction용 union
-  - `TelemetryPartUnion` — Part | string
-  - `TelemetryCandidate` — content + finishReason
-- `FinishReason` enum → `GeminiFinishReason` const 객체 (문자열 리터럴)
-- `OutputMessage.finish_reason` 타입: `FinishReason | string` → `string`
-
-### 3.0.3.1: loggingContentGenerator + types.ts 독립화
-
-**파일**: `core/loggingContentGenerator.ts`, `telemetry/types.ts`,
-`core/contentGenerator.ts`
-
-**types.ts 추가 변경**:
-
-- `Content` → `TelemetryContent` (semantic.ts에서)
-- `Candidate` → `TelemetryCandidate` (semantic.ts에서)
-- `GenerateContentConfig` → `TelemetryGenerateConfig` (로컬 인터페이스)
-- `@google/genai` import 완전 제거
-
-**contentGenerator.ts**:
-
-- `GenerateContentParameters`, `GenerateContentResponse` 등 6개 SDK 타입
-  re-export 추가
-
-**loggingContentGenerator.ts**:
-
-- interface method 타입: `contentGenerator.ts` re-export 경유
-- telemetry 타입: `TelemetryContent`, `TelemetryCandidate`,
-  `TelemetryGenerateConfig`, `TelemetryUsageMetadata`
-- `@google/genai` import 완전 제거
-
-### 3.0.3.3: AgentChatSession 인터페이스 도입 (Q5)
-
-**파일**: `agents/types.ts`, `agents/local-executor.ts`,
-`services/chatCompressionService.ts`
-
-**AgentChatSession 인터페이스** (`agents/types.ts`):
-
-```typescript
-export interface AgentChatSession {
-  sendMessageStream(...): Promise<AsyncGenerator<StreamEvent>>;
-  setHistory(history: Content[]): void;
-  getHistory(curated?: boolean): Content[];
-  getLastPromptTokenCount(): number;
-}
-```
-
-**ChatSessionFactory 타입** (`agents/types.ts`):
-
-```typescript
-export type ChatSessionFactory = (
-  config: Config,
-  systemInstruction: string | undefined,
-  tools: Tool[],
-  history: Content[],
-) => AgentChatSession;
-```
-
-**LocalAgentExecutor 변경**:
-
-- `new GeminiChat()` 직접 호출 → `this.chatFactory()` factory 호출
-- 모든 private 메서드의 `chat: GeminiChat` → `chat: AgentChatSession`
-- `create()` static method에 optional `chatFactory` 파라미터 추가
-- default factory: `defaultChatSessionFactory` (GeminiChat 생성)
-- **[리뷰 반영]** `chatFactory` 주입 경로 회귀 테스트 추가
-  (`local-executor.test.ts`): custom factory 주입 시 GeminiChat 미호출 검증
-
-**ChatCompressionService 변경**:
-
-- `compress(chat: GeminiChat)` → `compress(chat: AgentChatSession)`
-- `client.ts` 호출자: GeminiChat이 AgentChatSession을 구조적으로 만족하므로 변경
-  불필요
-
-## Quality Gate
-
-| 항목       | 결과                                                              |
-| ---------- | ----------------------------------------------------------------- |
-| TypeCheck  | ✅ PASS                                                           |
-| ESLint     | ✅ PASS                                                           |
-| Core Tests | ✅ 260 files / 4854 passed (baseline 4849 + 신규 2 + 리뷰 반영 3) |
-
-## @google/genai 제거 현황
-
-| 파일                              | Before                   | After                                   |
-| --------------------------------- | ------------------------ | --------------------------------------- |
-| `telemetry/sdk.ts`                | 0 imports                | 0 imports (핸들러 누수만 수정)          |
-| `telemetry/types.ts`              | 3 type imports           | 0 imports ✅                            |
-| `telemetry/semantic.ts`           | 1 value + 5 type imports | 0 imports ✅                            |
-| `core/loggingContentGenerator.ts` | 10 type imports          | 0 imports ✅                            |
-| `agents/local-executor.ts`        | 1 value + 5 type imports | 1 value + 6 type imports (factory 내부) |
-
-> **Note — Agent 독립화 범위 명확화 [리뷰 반영]**:
->
-> M3.0.3에서 달성한 것은 **구조적 결합 해소**(factory 패턴)이며, **타입 수준의
-> 완전 독립화는 아님**. `AgentChatSession` 인터페이스 자체가 `StreamEvent`
-> (`providers/gemini/chat.ts`), `Content`, `Tool` (`@google/genai`) 등 Gemini
-> 전용 타입에 여전히 의존한다.
->
-> - 달성: GeminiChat **클래스** 직접 결합 제거 → factory 주입으로 구현체 교체
->   가능
-> - 미달성: AgentChatSession **메서드 시그니처** 의 프로바이더 중립 타입 전환
-> - 향후: agent 레이어 전체의 타입 독립화는 Phase 3 후반부(M3.1+ 신규 프로바이더
->   구현 시) 범위. `Content` → `LlmMessage`, `StreamEvent` → `LlmStreamEvent`,
->   `Tool` → `LlmTool` 등 점진적 전환 예정.
-
-## 설계 결정
-
-### Q5: AgentChatSession 인터페이스 형태
-
-- **결정**: 잠정 방안 그대로 적용 — `AgentChatSession` 추상 인터페이스 +
-  `ChatSessionFactory` 타입
-- **근거**: GeminiChat 직접 결합만 해소하고, 전체 타입 독립화는 점진적으로 진행
-- **향후**: 다른 프로바이더 구현 시 factory를 교체하여 chat session 주입 가능
-
-### Q6: Telemetry Usage 스키마
-
-- **결정**: `TelemetryUsageMetadata` 로컬 인터페이스 (SDK 6개 필드 동일)
-- **근거**: structural typing으로 SDK 객체 호환 유지, provider-independent
-
-## 커밋
-
-- `6a09c831d` — refactor(providers): M3.0.3 — 텔레메트리/Agent 레이어
-  @google/genai 독립화
-- `83c71856b` — docs: M3.0.3 작업 결과서
-
-## 리뷰 반영 (2026-02-09)
-
-### 이슈 #1 [Medium]: sdk.start() 실패 시 시그널 핸들러 누수
-
-- **현상**: `initializeTelemetry()`가 `sdk.start()` 실패 여부와 무관하게
-  SIGTERM/SIGINT 핸들러를 등록. `shutdownTelemetry()`는
-  `telemetryInitialized=false`일 때 조기 반환하여 핸들러 제거 로직에 도달 불가.
-  반복 실패 시 핸들러 누적.
-- **수정**: 시그널 핸들러 등록을 try 블록 내부, `telemetryInitialized = true`
-  이후로 이동. SDK가 시작되지 않으면 핸들러 자체가 등록되지 않으므로 누수 원천
-  차단.
-- **테스트**: `should not register signal handlers when sdk.start() fails` 신규
-  추가 (19/19 PASS)
-
-### 이슈 #2 [Low]: ChatSessionFactory 주입 경로 회귀 테스트 부재
-
-- **현상**: `create()` static method에 `chatFactory` 파라미터가 추가되었으나,
-  custom factory 주입 시 정상 동작을 검증하는 테스트 케이스 없음.
-- **수정**: `should use custom chatFactory when provided` 테스트 추가. custom
-  factory 주입 → GeminiChat 생성자 미호출 + custom factory 1회 호출 검증.
-- **테스트**: 38/38 PASS (신규 1건)
-
-### 이슈 #3 [Low]: Agent 레이어 독립화 부분 완료 상태
-
-- **현상**: `AgentChatSession` 인터페이스가 `StreamEvent`, `Content`, `Tool` 등
-  Gemini 전용 타입에 여전히 의존. 구조적 결합(factory 패턴)은 해소되었으나 타입
-  수준의 완전 독립화는 미달성.
-- **판정**: 코드 수정 불요 — M3.0.3 범위는 "GeminiChat 클래스 직접 결합
-  해소"이며, agent 레이어 전체의 타입 독립화는 Phase 3 후반부(M3.1+ 신규
-  프로바이더 구현 시) 범위로 명시.
-- **조치**: 작업 결과서 Note 섹션에 달성/미달성 범위 및 향후 전환 계획 명확화.
-
-### 리뷰 반영 Quality Gate (1차)
-
-| 항목       | 결과                                              |
-| ---------- | ------------------------------------------------- |
-| TypeCheck  | ✅ PASS                                           |
-| ESLint     | ✅ PASS                                           |
-| Core Tests | ✅ 260 files / 4853 passed (신규 2건)             |
-| 변경 파일  | `sdk.ts`, `sdk.test.ts`, `local-executor.test.ts` |
-
-## 2차 리뷰 반영 (2026-02-09)
-
-### 이슈 #4 [Low]: 지연 초기화(useCliAuth) 경로의 post_auth 리스너 미정리
-
-- **현상**: `useCliAuth=true` + 무자격증명 경로에서 `authListener`가
-  `authEvents.on('post_auth', ...)` 에 등록되지만, `telemetryInitialized`는
-  `false` 유지. `shutdownTelemetry()` 호출 시 `!telemetryInitialized` 가드에서
-  조기 반환하여 리스너 정리(finally 블록)에 도달 불가. 프로세스 수명 동안 리스너
-  잔존 및 테스트 격리 시 상태 오염 가능.
-- **수정**: 리스너 정리(`sigTermHandler`, `sigIntHandler`, `authListener`,
-  `callbackRegistered`, `activeTelemetryEmail`) 를 조기 반환 가드 **이전**으로
-  이동하여 무조건 실행. SDK 전용 정리(`sdk.shutdown()`, trace/context/metrics
-  disable)만 가드 후 실행.
-- **테스트**:
-  `should clean up post_auth listener on shutdown even when SDK was never started (deferred init path)`
-  신규 추가 (20/20 PASS)
-
-### 이슈 #5 [Low]: CoreEventEmitter MaxListenersExceededWarning
-
-- **현상**: 테스트 실행 중 `CoreEventEmitter` 관련 MaxListenersExceededWarning
-  관찰. 싱글턴 emitter (`utils/events.ts:303`) 에서 `model-changed` 리스너 누적.
-- **판정**: M3.0.3 범위 밖 — telemetry signal handler 이슈와는 별개.
-  `makeFakeConfig()` 가 테스트마다 신규 리스너를 등록하되 싱글턴 emitter에서
-  제거하지 않는 구조로 추정. 별도 정리 이슈로 추적 필요.
-- **조치**: 문서 기록만 수행. M3.0 범위 내 추가 수정 불요.
-
-### 2차 리뷰 반영 Quality Gate
-
-| 항목       | 결과                                |
-| ---------- | ----------------------------------- |
-| TypeCheck  | ✅ PASS                             |
-| ESLint     | ✅ PASS                             |
-| Core Tests | ✅ 260 files / 4854 passed (신규 1) |
-| 변경 파일  | `sdk.ts`, `sdk.test.ts`             |

package/dist/docs/00_project/ai_adapter/working_history/Phase3_M3.0.4_/353/263/200/355/231/230/353/270/214/353/246/277/354/247/200/354/240/225/353/246/254_20260209.md

@@ -1,136 +0,0 @@
-# M3.0.4 작업 결과서 — 변환 브릿지 정리
-
-- **작업일**: 2026-02-09
-- **브랜치**: `DID/v0.1`
-- **상태**: ✅ 완료
-
-## 작업 목표
-
-`geminiTypeConversion.ts` 브릿지를 `providers/gemini/` 정식 위치로 이동하고,
-dead code (`messageInspectors.ts`)를 제거하여 Gemini 전용 변환 유틸의 소유권을
-명확화한다.
-
-## 작업 순서 및 결과
-
-| 순서 | Sub-task | 작업 내용                                                         | 테스트 결과 |
-| ---- | -------- | ----------------------------------------------------------------- | ----------- |
-| 1    | 3.0.4.1  | 브릿지 사용처 분석 (6개 사이트, 5개 exported 함수)                | N/A (분석)  |
-| 2    | 3.0.4.2  | `providers/gemini/typeConversion.ts` 생성 + 6개 import 경로 전환  | 29/29 PASS  |
-| 3    | 3.0.4.3  | `utils/geminiTypeConversion.ts` → @deprecated re-export shim 전환 | 29/29 PASS  |
-| 4    | 3.0.4.3  | `messageInspectors.ts` dead code 삭제                             | 4854 PASS   |
-
-## 변경 파일 상세
-
-### 3.0.4.1: 사용처 분석
-
-6개 사용처 확인, 2가지 패턴으로 분류:
-
-**변환 함수** (2곳 — 모델 라우팅):
-
-| 파일                       | 함수                                                                | 입력 소스                         |
-| -------------------------- | ------------------------------------------------------------------- | --------------------------------- |
-| `core/client.ts`           | `convertContentsToLlmMessages`, `convertPartListUnionToLlmContents` | `chat.getHistory(true)` Content[] |
-| `agents/local-executor.ts` | `convertContentsToLlmMessages`, `convertPartListUnionToLlmContents` | `chat.getHistory(true)` Content[] |
-
-**검사 함수** (4곳 — Content 타입 가드):
-
-| 파일                               | 함수                                                     | 용도                     |
-| ---------------------------------- | -------------------------------------------------------- | ------------------------ |
-| `providers/gemini/chat.ts`         | `isContentToolResultMessage`                             | 녹음 시 tool result 스킵 |
-| `services/loopDetectionService.ts` | `isContentToolCallMessage`, `isContentToolResultMessage` | 히스토리 정리/루프 감지  |
-| `utils/nextSpeakerChecker.ts`      | `isContentToolResultMessage`                             | 다음 발화자 결정         |
-| `utils/editCorrector.ts`           | `isContentToolCallMessage`, `isContentToolResultMessage` | 편집 타임스탬프 추출     |
-
-모든 함수가 Gemini SDK 타입(`Content`, `Part`, `PartListUnion`)을 입력으로
-받으므로 `providers/gemini/`가 정식 소속 위치.
-
-### 3.0.4.2: 파일 이동 + Import 전환
-
-**신규 파일**: `providers/gemini/typeConversion.ts`
-
-- `utils/geminiTypeConversion.ts` 전체 내용을 이동
-- import 경로 조정: `../providers/types.js` → `../types.js`, `./llmUtils.js` →
-  `../../utils/llmUtils.js`
-
-**Import 전환** (6개 사용처):
-
-| 파일                               | Before                                | After                                   |
-| ---------------------------------- | ------------------------------------- | --------------------------------------- |
-| `agents/local-executor.ts`         | `../utils/geminiTypeConversion.js`    | `../providers/gemini/typeConversion.js` |
-| `providers/gemini/chat.ts`         | `../../utils/geminiTypeConversion.js` | `./typeConversion.js`                   |
-| `core/client.ts`                   | `../utils/geminiTypeConversion.js`    | `../providers/gemini/typeConversion.js` |
-| `services/loopDetectionService.ts` | `../utils/geminiTypeConversion.js`    | `../providers/gemini/typeConversion.js` |
-| `utils/nextSpeakerChecker.ts`      | `./geminiTypeConversion.js`           | `../providers/gemini/typeConversion.js` |
-| `utils/editCorrector.ts`           | `../utils/geminiTypeConversion.js`    | `../providers/gemini/typeConversion.js` |
-
-**테스트 파일**: `utils/geminiTypeConversion.test.ts` import도
-`../providers/gemini/typeConversion.js`로 전환
-
-**providers/gemini/index.ts**: 5개 함수 re-export 추가
-
-### 3.0.4.3: @deprecated re-export + dead code 삭제
-
-**`utils/geminiTypeConversion.ts`** → @deprecated re-export shim:
-
-```typescript
-/**
- * @deprecated Import from '../providers/gemini/typeConversion.js' instead.
- * This re-export shim exists for backward compatibility and will be removed
- * after all internal consumers migrate to the canonical path.
- */
-export {
-  convertContentToLlmMessage,
-  convertContentsToLlmMessages,
-  convertPartListUnionToLlmContents,
-  isContentToolCallMessage,
-  isContentToolResultMessage,
-} from '../providers/gemini/typeConversion.js';
-```
-
-**`utils/messageInspectors.ts`** — 삭제:
-
-- 0개 import 확인 (grep으로 전수 검색)
-- 2개 deprecated 함수(`isFunctionCall`, `isFunctionResponse`)
-- M3.0.2에서 모든 사용처가 `geminiTypeConversion.ts`로 이미 마이그레이션 완료
-- 테스트 파일 미존재
-
-## Quality Gate
-
-| 항목       | 결과                       |
-| ---------- | -------------------------- |
-| TypeCheck  | ✅ PASS                    |
-| ESLint     | ✅ PASS                    |
-| Core Tests | ✅ 260 files / 4854 passed |
-
-## 설계 결정
-
-### 이동 vs 인라인 vs 제거
-
-- **결정**: `utils/` → `providers/gemini/` 이동 + @deprecated re-export
-- **근거**:
-  - 모든 함수가 Gemini SDK 타입을 입력으로 받으므로 providers/gemini/가 정식
-    소속
-  - chat history가 `Content[]`인 동안은 변환 함수가 필수 — 제거 불가
-  - 인라인은 코드 중복 증가 — 단일 소스 유지가 바람직
-  - @deprecated re-export로 점진적 마이그레이션 경로 확보
-
-### messageInspectors.ts 삭제 근거
-
-- M3.0.2에서 4개 사용처 모두 `geminiTypeConversion.ts`의 안전한 대체 함수로 전환
-  완료
-- grep 전수 검색: `from.*messageInspectors` → 0 matches
-- core/index.ts에서 export하지 않음 → 외부 소비자 없음
-
-## 향후 작업
-
-- `utils/geminiTypeConversion.ts` re-export shim 제거: 모든 소비자가 정식 경로로
-  이동 완료 시 (현재는 테스트 파일만 re-export 경유)
-- chat history `Content[]` → `LlmMessage[]` 전환 시 변환 함수 자체 불필요화
-  (Phase 3 후반부)
-- 검사 함수(`isContentToolCallMessage` 등)는 Gemini 프로바이더 내부 유틸로 유지
-
-## 커밋
-
-- `4f0eec16a` — refactor(providers): M3.0.4 — 변환 브릿지 정리 (typeConversion
-  이동
-  - dead code 삭제)

package/dist/docs/00_project/ai_adapter/working_history/Phase3_M3.0.5_/353/237/260/355/203/200/354/236/204/354/213/244/355/226/211/352/262/275/353/241/234/354/227/260/352/262/260_20260209.md

@@ -1,232 +0,0 @@
-# M3.0.5 작업 결과서 — 런타임 실행 경로 연결
-
-- **작업일**: 2026-02-09
-- **브랜치**: `DID/v0.1`
-- **상태**: ✅ 완료
-
-## 작업 목표
-
-`createContentGenerator()`의 하드코딩된 `new GoogleGenAI()` 경로를
-`ProviderFactory`/`ProviderRegistry`/`selectProvider()`와 연결하여,
-`ENABLE_MULTI_PROVIDER=true` 시 비-Gemini 프로바이더가 런타임에서 도달
-가능하도록 한다.
-
-## 작업 순서 및 결과
-
-| 순서 | Sub-task | 작업 내용                                                                              | 테스트 결과      |
-| ---- | -------- | -------------------------------------------------------------------------------------- | ---------------- |
-| 1    | 3.0.5.4  | `bootstrapGeminiProvider()` 함수 생성 + has() 가드 + 7개 테스트                        | 7/7 PASS         |
-| 2    | 3.0.5.1  | `contentGenerator.ts` — 멀티 프로바이더 분기 추가                                      | TypeCheck PASS   |
-| 3    | 3.0.5.3  | `ENABLE_MULTI_PROVIDER` 플래그 분기: off→레거시, on+Gemini→레거시, on+비Gemini→Factory | 10/10 PASS       |
-| 4    | 3.0.5.2  | `ProviderFactory.create()` 런타임 경로 연결                                            | 통합 테스트 포함 |
-| 5    | 3.0.5.5  | 7개 회귀 시나리오 + 3개 추가 테스트                                                    | 10/10 PASS       |
-
-## 변경 파일 상세
-
-### 3.0.5.4: bootstrapGeminiProvider
-
-**신규 파일**: `providers/gemini/bootstrap.ts`
-
-- `bootstrapGeminiProvider(registry?)`: ProviderRegistry에 Gemini 팩토리 등록
-- `has()` 가드 패턴으로 중복 등록 안전성 확보
-- 팩토리 내부: `new GoogleGenAI(config)` → `new GeminiAdapter(config, models)`
-- `providers/gemini/index.ts`에 re-export 추가
-
-**테스트 파일**: `providers/gemini/bootstrap.test.ts` (7개 테스트)
-
-- 등록 확인, 중복 호출 안전성, 어댑터 생성, 싱글톤 사용, config 전달 (apiKey,
-  vertexai, 빈 apiKey)
-
-### 3.0.5.1+3: contentGenerator.ts 멀티 프로바이더 분기
-
-**수정 파일**: `core/contentGenerator.ts`
-
-**추가 import** (7개):
-
-- `isMultiProviderEnabled` (featureFlag)
-- `selectProvider` (providerSelector)
-- `ProviderType` (providerTypes)
-- `ProviderFactory` (factory)
-- `bootstrapGeminiProvider` (bootstrap)
-- `BaseAdapter` (baseAdapter, type-only)
-- `AuthType as ProviderAuthType` (providerTypes, type-only)
-
-**추가 함수**:
-`wrapAdapterAsGenerator(adapter: BaseAdapter): GeminiContentGenerator`
-
-- 비-Gemini 프로바이더의 BaseAdapter를 GeminiContentGenerator 인터페이스로 래핑
-- 레거시 메서드 (generateContent 등): 에러 throw ("does not support legacy
-  Gemini API")
-- llm\* 메서드: adapter에 위임 (generateContent, generateContentStream,
-  countTokens)
-- `isProviderIndependentGenerator()` 타입 가드로 llm\* 가용성 검출 가능
-
-**멀티 프로바이더 분기** (L269-L287):
-
-```typescript
-if (isMultiProviderEnabled()) {
-  const selection = selectProvider({
-    authType: config.authType as unknown as ProviderAuthType,
-  });
-  if (selection.type !== ProviderType.Gemini) {
-    bootstrapGeminiProvider();
-    const factory = new ProviderFactory();
-    const adapter = factory.create(selection.type, {
-      apiKey: selection.apiKey,
-      baseUrl: selection.baseUrl,
-    });
-    return new LoggingContentGenerator(
-      wrapAdapterAsGenerator(adapter),
-      gcConfig,
-    );
-  }
-  // Gemini: fall through to existing paths
-}
-```
-
-### 3.0.5.5: 회귀 테스트
-
-**신규 파일**: `core/contentGenerator.multiProvider.test.ts` (10개 테스트)
-
-7개 회귀 시나리오:
-
-| #   | ENABLE_MULTI_PROVIDER | LLM_PROVIDER | authType      | 기대 결과        | 결과 |
-| --- | --------------------- | ------------ | ------------- | ---------------- | ---- |
-| 1   | false                 | (미설정)     | USE_GEMINI    | Gemini (legacy)  | ✅   |
-| 2   | false                 | claude       | USE_GEMINI    | Gemini (legacy)  | ✅   |
-| 3   | true                  | (미설정)     | USE_GEMINI    | Gemini           | ✅   |
-| 4   | true                  | claude       | (미설정)      | Claude           | ✅   |
-| 5   | true                  | openai       | USE_VERTEX_AI | OpenAI           | ✅   |
-| 6   | true                  | (미설정)     | USE_VERTEX_AI | Gemini           | ✅   |
-| 7   | true                  | (미설정)     | (미설정)      | Gemini (default) | ✅   |
-
-3개 추가 테스트:
-
-- llmGenerateContent 위임 동작 확인
-- 레거시 generateContent 에러 throw 확인 (비-Gemini)
-- 부트스트랩 멱등성 (2회 연속 호출)
-
-## Quality Gate
-
-| 항목       | 결과                       |
-| ---------- | -------------------------- |
-| TypeCheck  | ✅ PASS                    |
-| ESLint     | ✅ PASS                    |
-| Core Tests | ✅ 262 files / 4876 passed |
-
-**변화**: 기준선 260 files / 4859 → +2 files, +17 tests
-
-## 설계 결정
-
-### 부트스트랩 전략
-
-- **결정**: `has()` 가드 패턴
-- **근거**: `force: true`는 기존 등록 덮어쓰기 위험, 1회 초기화 플래그는 모듈
-  레벨 상태 추가 필요. `has()` 가드가 가장 단순하고 안전.
-- **위치**: `createContentGenerator()` 진입부 (비-Gemini 분기 내)
-- 매 호출마다 실행되나 `has()` 체크가 O(1)이므로 성능 영향 무시 가능
-
-### wrapAdapterAsGenerator 설계
-
-- **결정**: 레거시 메서드 throw + llm\* 위임 패턴
-- **근거**: 비-Gemini 프로바이더는 Gemini SDK 타입을 지원할 수 없으므로 레거시
-  메서드는 명확한 에러 메시지와 함께 throw. CLI 코드가 llm\* 메서드로 전환되면
-  (M3.1+) 완전 동작 가능.
-- `isProviderIndependentGenerator()` 타입 가드로 호출 전 분기 가능
-
-### 멀티 프로바이더 분기 위치
-
-- **결정**: baseHeaders 설정 후, OAuth/API key 분기 전
-- **근거**: 비-Gemini 프로바이더는 Gemini-specific 헤더(인증, User-Agent)가
-  불필요하므로 조기 반환. Gemini 선택 시 기존 코드로 fall-through.
-
-### AuthType 호환성
-
-- **결정**: `config.authType as unknown as ProviderAuthType` 캐스팅
-- **근거**: 두 AuthType enum이 동일한 문자열 값 보유 (core vs providers). 타입
-  시스템에서 nominal typing이므로 `as unknown as` 필요. 값은 동일하여 런타임
-  안전.
-
-## 향후 작업
-
-- M3.1~M3.3: 각 프로바이더 어댑터 구현 + `registry.register()` 호출 추가
-  - Claude: `registry.register('claude', (config) => new ClaudeAdapter(config))`
-  - OpenAI: `registry.register('openai', (config) => new OpenAIAdapter(config))`
-- CLI 코드: `isProviderIndependentGenerator()` 분기 추가하여 llm\* 메서드 사용
-- `wrapAdapterAsGenerator` 개선: 텔레메트리 통합, 에러 매핑 등
-
-## 리뷰 반영 (2026-02-09)
-
-### 이슈 1 (중간): LLM_PROVIDER=gemini + authType 미설정 시 런타임 실패
-
-**문제**: `ENABLE_MULTI_PROVIDER=true`, `LLM_PROVIDER=gemini` (또는 env key만
-존재), `authType` 미설정 시 `selectProvider()`는 Gemini + apiKey를 정상
-반환하지만, fall-through 후 레거시 분기에서 `authType`이 없어 "Unsupported
-authType" throw.
-
-**수정**: Gemini 선택 + `authType` 미설정 + `selection.apiKey` 존재 시
-`config`을 `{ authType: USE_GEMINI, apiKey: selection.apiKey }`로 보정하여
-레거시 분기에 안전하게 도달하도록 함.
-
-```typescript
-if (!config.authType && selection.apiKey) {
-  config = {
-    ...config,
-    authType: AuthType.USE_GEMINI,
-    apiKey: selection.apiKey,
-  };
-}
-```
-
-**회귀 테스트 추가** (2개):
-
-| #   | ENABLE_MULTI_PROVIDER | LLM_PROVIDER | GEMINI_API_KEY | authType | 기대 결과         | 결과 |
-| --- | --------------------- | ------------ | -------------- | -------- | ----------------- | ---- |
-| 8   | true                  | gemini       | ✅             | (미설정) | Gemini (backfill) | ✅   |
-| 9   | true                  | (미설정)     | ✅             | (미설정) | Gemini (backfill) | ✅   |
-
-### 이슈 2 (낮음): 비-Gemini 프로바이더 팩토리 미등록
-
-**상태**: 의도된 제한. `bootstrapGeminiProvider()`만 프로덕션 코드에 존재하며,
-Claude/OpenAI/Didim 어댑터 등록은 M3.1~M3.3 범위에서 구현 예정.
-`LLM_PROVIDER=claude` 등 사용 시 `Provider not registered` 에러는 현재 정상
-동작.
-
-### Quality Gate (리뷰 반영 후)
-
-| 항목        | 결과                                                                 |
-| ----------- | -------------------------------------------------------------------- |
-| TypeCheck   | ✅ PASS                                                              |
-| ESLint      | ✅ PASS                                                              |
-| 관련 테스트 | ✅ 12/12 (multiProvider)                                             |
-| 회귀 테스트 | ✅ 56/56 (contentGenerator + providerSelector + factory + bootstrap) |
-
-## M3.0 전체 리뷰 — 알려진 제한사항 (2026-02-09)
-
-M3.0 전체 리뷰에서 아래 2건이 의도된 제한사항으로 확인되었습니다. 코드 수정
-불필요, 후속 마일스톤에서 해소 예정.
-
-### 제한 1 (중간): 비-Gemini 프로바이더 런타임 미등록
-
-- `ProviderFactory.create()` 경로는 연결되었으나 등록된 팩토리는 Gemini만 존재
-- `LLM_PROVIDER=claude/openai/didim` → `Provider not registered` 런타임 실패
-- 테스트는 수동 `registry.register()`로 검증 (프로덕션 등록 코드 미존재)
-- **해소**: M3.1 (Claude), M3.2 (OpenAI), M3.3 (Didim) 어댑터 구현 시
-
-### 제한 2 (낮음): Agent 실행 경로 Gemini 고정
-
-- `local-executor.ts`의 `defaultChatSessionFactory`가 `new GeminiChat()` 직접
-  생성
-- `local-invocation.ts`에서 커스텀 factory 미주입
-- 메인 생성기 경로 확장과 무관하게 subagent 루프는 Gemini 고정
-- **해소**: CLI 멀티 프로바이더 통합 시 `ChatSessionFactory` DI 전환
-
-상세 내역은 `docs/ai_adapter/todolist/phase3_handoff.md` §8 참조.
-
-## 커밋
-
-- `54cf15f0b` feat(providers): M3.0.5 — 런타임 실행 경로 연결 (multi-provider
-  runtime wiring)
-- `3c8992f52` docs: M3.0.5 작업 결과서 — 커밋 ID 기록
-- `e3b81db49` fix(providers): M3.0.5 리뷰 반영 — Gemini 선택 시 authType
-  backfill 보정