@didim365/agent-cli-core 0.1.0 → 0.1.2

package/dist/docs/00_project/ai_adapter/working_history/Phase2_M2.4_ModelConfigService/355/230/270/355/231/230/353/240/210/354/235/264/354/226/264_20260208.md

@@ -1,275 +0,0 @@
-# Phase 2: M2.4 ModelConfigService 호환 레이어 작업 결과서
-
-> 📅 **작업일**: 2026-02-08 📚 **Phase**: Phase 2 - M2.4 🎯 **목표**:
-> ModelConfigService의 GenerateContentConfig 의존성 해결 — 양방향 변환기 +
-> Bridge 래퍼 🔗 **이전 작업**:
-> [Phase2_M2.3_GeminiAdapter구현\_20260208.md](./Phase2_M2.3_GeminiAdapter구현_20260208.md)
-> 🔗 **관련 문서**:
-> [phase2_core_refactoring_todolist.md](../todolist/phase2_core_refactoring_todolist.md) -
-> M2.4
-
----
-
-## 📋 작업 요약
-
-### 2.4.1 호환 레이어 구현 ✅
-
-#### 2.4.1.1 LlmModelConfig 인터페이스 정의 ✅
-
-| 항목                                | 상태 | 비고                                               |
-| ----------------------------------- | :--: | -------------------------------------------------- |
-| `LlmModelConfig` 인터페이스         |  ✅  | model?, provider?, llmConfig?                      |
-| `LlmModelConfigKey` 인터페이스      |  ✅  | model, provider?, overrideScope?, isRetry?         |
-| `ResolvedLlmModelConfig` 인터페이스 |  ✅  | model, provider, llmConfig, generateContentConfig? |
-
-#### 2.4.1.2 GenerateContentConfig 래퍼 구현 ✅ (ConfigConverter)
-
-| 항목                                    | 상태 | 비고                                                                                         |
-| --------------------------------------- | :--: | -------------------------------------------------------------------------------------------- |
-| `fromGenerateContentConfig(gc, model)`  |  ✅  | GC → LlmGenerateConfig 변환                                                                  |
-| `toGenerateContentConfig(lc)`           |  ✅  | LlmGenerateConfig → GC 역변환                                                                |
-| COMMON_FIELDS 직접 매핑 (7개)           |  ✅  | temperature, topP, topK, maxOutputTokens, stopSequences, responseMimeType, systemInstruction |
-| EXCLUDED_FIELDS 제외 (2개)              |  ✅  | httpOptions, abortSignal (인프라 전용)                                                       |
-| Gemini-specific → providerOptions       |  ✅  | presencePenalty, seed, thinkingConfig, safetySettings 등                                     |
-| responseMimeType ↔ responseFormat      |  ✅  | application/json ↔ json, text/plain ↔ text                                                 |
-| systemInstruction ContentUnion → string |  ✅  | string, Content, Part[] 지원 (리뷰 수정 후)                                                  |
-| Round-trip 보존                         |  ✅  | from → to 라운드트립으로 필드 보존 검증                                                      |
-
-**테스트**: 21개 (configConverter.test.ts, 리뷰 수정 후)
-
-#### 2.4.1.3 설정 머지 로직 확장 ✅
-
-| 항목                                                | 상태 | 비고                                 |
-| --------------------------------------------------- | :--: | ------------------------------------ |
-| `ModelConfigBridge.mergeLlmModelConfig()`           |  ✅  | static 메서드, base + override 병합  |
-| model/provider 오버라이드                           |  ✅  | override 우선                        |
-| llmConfig 1단계 spread + providerOptions deep merge |  ✅  | undefined 필터링 포함 (리뷰 수정 후) |
-| 빈 base/override 처리                               |  ✅  | 양쪽 모두 빈 객체 지원               |
-
-#### 2.4.1.4 프로바이더별 설정 분기 ✅
-
-| 항목                                   | 상태 | 비고                                     |
-| -------------------------------------- | :--: | ---------------------------------------- |
-| Gemini: ModelConfigService 위임 + 변환 |  ✅  | resolveGemini() — 기존 서비스 활용       |
-| Non-Gemini: 등록된 LlmModelConfig 해결 |  ✅  | resolveNonGemini() — registerLlmConfig() |
-| 기본 프로바이더 gemini 폴백            |  ✅  | provider 미지정 시 gemini                |
-| alias 체인 해결 (Gemini)               |  ✅  | chat-model → base → gemini-2.0-flash     |
-| override 적용 (isRetry, overrideScope) |  ✅  | ModelConfigService 기존 로직 활용        |
-| 레거시 passthrough                     |  ✅  | getResolvedConfig() → ModelConfigService |
-
-**테스트**: 23개 (modelConfigBridge.test.ts, 리뷰 수정 후)
-
-### 2.4.2 ModelRouterService 연동 → M2.6 이월
-
-| 항목                            | 상태 | 비고                                  |
-| ------------------------------- | :--: | ------------------------------------- |
-| 2.4.2.1 라우팅 컨텍스트 확장    |  ⏸️  | M2.6 라우팅 레이어 타입 독립화와 통합 |
-| 2.4.2.2 프로바이더 인식 라우팅  |  ⏸️  | M2.6에서 처리                         |
-| 2.4.2.3 기존 라우팅 전략 호환성 |  ⏸️  | M2.6에서 처리                         |
-
-**이월 사유**: M2.6이 routingStrategy.ts의 `@google/genai` 타입 독립화를
-다루므로, 라우팅 컨텍스트 확장과 프로바이더 인식 라우팅을 함께 처리하는 것이
-효율적.
-
----
-
-## 📊 검증 결과
-
-| 검증 항목                     |       결과        | 비고                               |
-| ----------------------------- | :---------------: | ---------------------------------- |
-| 전체 테스트                   | ✅ 4764/4764 pass | 기존 4720 + 신규 44 (리뷰 수정 후) |
-| TypeScript 컴파일             |      ✅ 클린      | tsc --noEmit 0 errors              |
-| ESLint                        |      ✅ 통과      | pre-commit hook 통과               |
-| 기존 기능 100% 동작           |        ✅         | 기존 테스트 전체 통과              |
-| ConfigConverter 라운드트립    |        ✅         | 기본 필드 + providerOptions 보존   |
-| ModelConfigBridge Gemini 해결 |        ✅         | ModelConfigService 위임 정상       |
-| ModelConfigBridge Non-Gemini  |        ✅         | claude/openai 프로바이더 해결      |
-
----
-
-## 📁 파일 목록
-
-### 신규 생성
-
-| 파일                                       | 용도                                                   | LOC  |
-| ------------------------------------------ | ------------------------------------------------------ | ---- |
-| `providers/gemini/configConverter.ts`      | GenerateContentConfig ↔ LlmGenerateConfig 양방향 변환 | ~200 |
-| `providers/gemini/configConverter.test.ts` | ConfigConverter TDD 테스트 (19개)                      | ~260 |
-| `services/modelConfigBridge.ts`            | ModelConfigService 래핑 — 프로바이더 독립 설정 해결    | ~185 |
-| `services/modelConfigBridge.test.ts`       | ModelConfigBridge TDD 테스트 (21개)                    | ~397 |
-
-### 수정
-
-| 파일                        | 변경 내용                                                      |
-| --------------------------- | -------------------------------------------------------------- |
-| `providers/gemini/index.ts` | fromGenerateContentConfig, toGenerateContentConfig export 추가 |
-
----
-
-## 🔑 핵심 설계 결정
-
-### 1. Bridge 패턴 선택 (ModelConfigBridge)
-
-**문제**: ModelConfigService는 `GenerateContentConfig` (Gemini SDK)에 깊이
-결합되어 있음 (359라인, alias 체인, override 규칙 등).
-
-**결정**: 기존 ModelConfigService를 수정하지 않고 Bridge 클래스로 래핑.
-
-```
-ModelConfigBridge
-├── Gemini: ModelConfigService.getResolvedConfig() → fromGenerateContentConfig() → ResolvedLlmModelConfig
-└── Non-Gemini: registerLlmConfig() → resolveNonGemini() → ResolvedLlmModelConfig
-```
-
-**장점**:
-
-- 기존 ModelConfigService 코드 무변경 (회귀 위험 0)
-- alias 체인, override 규칙 등 복잡한 로직 재활용
-- Non-Gemini 프로바이더는 별도 경로로 독립 확장
-
-### 2. ConfigConverter 양방향 설계
-
-**문제**: GenerateContentConfig에는 ~50개 필드가 있으나 LlmGenerateConfig는 7개
-공통 필드만 지원.
-
-**결정**: 공통 필드는 직접 매핑, Gemini 전용 필드는 `providerOptions`에 보존.
-
-```
-Common (7): temperature, topP, topK, maxOutputTokens, stopSequences, responseMimeType, systemInstruction
-Excluded (2): httpOptions, abortSignal (인프라 전용)
-Provider-specific: providerOptions에 저장 (presencePenalty, seed, thinkingConfig, safetySettings 등)
-```
-
-**장점**: 라운드트립 보존 — `from → to`로 원본 복원 가능.
-
-### 3. 2.4.2 M2.6 이월
-
-**결정**: ModelRouterService 연동(2.4.2)을 M2.6으로 이월. **사유**: M2.6이
-routingStrategy.ts의 `Content`, `PartListUnion` 타입 제거를 다루므로, 라우팅
-컨텍스트 확장과 프로바이더 인식 라우팅을 함께 처리하는 것이 중복 방지 및 일관성
-면에서 효율적.
-
----
-
-## ⚠️ 다음 마일스톤 이월 사항
-
-### M2.5로 이월
-
-| 항목                                                  | 우선순위 | 비고          |
-| ----------------------------------------------------- | -------- | ------------- |
-| loggingContentGenerator ProviderApiResponseEvent 전환 | 중간     | M2.2에서 이월 |
-| client.ts GeminiEventType 참조 정리                   | 중간     | M2.2에서 이월 |
-| turn.ts 이벤트 생성점 전환                            | 중간     | M2.2에서 이월 |
-
-### M2.6으로 이월
-
-| 항목                          | 우선순위 | 비고                           |
-| ----------------------------- | -------- | ------------------------------ |
-| 2.4.2 ModelRouterService 연동 | 높음     | 라우팅 타입 독립화와 통합 처리 |
-
----
-
-## 🔄 리뷰 후 수정 사항
-
-### 이슈 1 [High]: Part[] systemInstruction 처리 깨짐
-
-**지적 내용**: `extractSystemInstructionText()`가 `string`과 `{parts: ...}`
-객체만 처리하고, 배열(`Part[]`)은 `String(instruction)`으로 떨어져
-`[object Object],...`가 됨. 작업 결과서의 "Part[] 지원" 주장과 불일치.
-
-**검증 결과**: 확인됨 — `[{text:'Be concise. '}, {text:'Be helpful.'}]` 입력 시
-`"[object Object],[object Object]"` 출력.
-
-**수정 내용**:
-
-| 항목                      | 변경                                                   |
-| ------------------------- | ------------------------------------------------------ |
-| `configConverter.ts:181`  | `Array.isArray()` 분기를 Content 객체 분기 앞에 추가   |
-| `configConverter.test.ts` | Content 객체 테스트 + Part[] 테스트 2개 추가 (19→21개) |
-
-```typescript
-// 추가된 분기 (Content 객체 검사 앞에 배치)
-if (Array.isArray(instruction)) {
-  return (instruction as Array<{ text?: string }>)
-    .map((p) => p.text || '')
-    .filter(Boolean)
-    .join('');
-}
-```
-
-### 이슈 2 [Medium]: mergeLlmModelConfig() shallow merge
-
-**지적 내용**: `...base.llmConfig, ...override.llmConfig`은 1단계 spread로,
-`providerOptions` 같은 중첩 `Record<string, unknown>` 객체가 override 시 통째로
-덮여 base 값이 유실됨.
-
-**검증 결과**: 확인됨 — base에 `{seed: 42}`, override에 `{presencePenalty: 0.8}`
-시 seed 유실.
-
-**수정 내용**:
-
-| 항목                        | 변경                                                             |
-| --------------------------- | ---------------------------------------------------------------- |
-| `modelConfigBridge.ts:125`  | 1단계 spread 후 providerOptions에 대해 별도 deep merge 추가      |
-| `modelConfigBridge.test.ts` | 중첩 providerOptions merge + 배열 교체 테스트 2개 추가 (21→23개) |
-
-```typescript
-// 1단계 spread 후 providerOptions 별도 merge
-if (base.llmConfig?.providerOptions || override.llmConfig?.providerOptions) {
-  result.llmConfig.providerOptions = {
-    ...base.llmConfig?.providerOptions,
-    ...Object.fromEntries(
-      Object.entries(override.llmConfig?.providerOptions ?? {}).filter(
-        ([, v]) => v !== undefined,
-      ),
-    ),
-  };
-}
-```
-
-**설계 결정**: `providerOptions`만 deep merge 대상으로 처리. 배열
-타입(`stopSequences`)은 의미적으로 통째로 교체가 올바르므로 shallow spread 유지.
-
-### 이슈 3 [Low]: ModelConfigBridge 프로덕션 미연결
-
-**지적 내용**: test 파일 외 사용처 없음. 실제 호출 경로 연결이 필요.
-
-**검증 결과**: 확인됨 — grep 결과 `modelConfigBridge.ts`와
-`modelConfigBridge.test.ts`에서만 참조.
-
-**대응**: 코드 수정 불필요. M2.4 스코프는 "호환 레이어 구현"까지이며, 실제
-프로덕션 연결은 후속 마일스톤(M2.5~M2.6)에서 `contentGenerator.ts`의 config 해결
-경로를 `ModelConfigBridge`로 전환할 때 수행 예정. M2.3 adapterBridge와 동일한
-패턴(구현 → 리뷰 → 연결)을 따름.
-
-### 수정 후 검증 결과
-
-| 검증 항목         |       결과        | 비고                  |
-| ----------------- | :---------------: | --------------------- |
-| 전체 테스트       | ✅ 4764/4764 pass | 기존 4760 + 신규 4    |
-| TypeScript 컴파일 |      ✅ 클린      | tsc --noEmit 0 errors |
-| ESLint            |      ✅ 통과      | pre-commit hook 통과  |
-
----
-
-## 📌 커밋 정보
-
-| 커밋 | 해시      | 설명                                                            |
-| ---- | --------- | --------------------------------------------------------------- |
-| feat | 4fa19a255 | feat(providers): M2.4 ModelConfigService 호환 레이어 구현       |
-| docs | 99185eb43 | docs: M2.4 작업 결과서 및 체크리스트 업데이트                   |
-| fix  | e095a0606 | fix(providers): M2.4 리뷰 수정 — Part[] 처리 및 deep merge 보정 |
-
----
-
-## ✅ 체크리스트
-
-- [x] 본작업 완료: 2.4.1 (configConverter + modelConfigBridge)
-- [x] 2.4.2 스코프 평가 후 M2.6 이월 결정
-- [x] 테스트: 44개 신규, 4764개 전체 통과
-- [x] TypeScript 컴파일: 클린
-- [x] ESLint: 통과 (pre-commit hook)
-- [x] 커밋: 4fa19a255 (feat), 99185eb43 (docs), e095a0606 (fix)
-- [x] 작업 결과서 작성
-- [x] 리뷰 이슈 수정: [High] Part[] 처리, [Medium] deep merge, [Low] 문서 명시
-- [x] 리뷰 수정 후 검증: 4764/4764 tests, TS clean

package/dist/docs/00_project/ai_adapter/working_history/Phase2_M2.5_/354/234/240/355/213/270/353/246/254/355/213/260/353/240/210/354/235/264/354/226/264/353/246/254/355/214/251/355/206/240/353/247/201_20260208.md

@@ -1,239 +0,0 @@
-# Phase 2: M2.5 유틸리티 레이어 리팩토링 작업 결과서
-
-> 📅 **작업일**: 2026-02-08 📚 **Phase**: Phase 2 - M2.5 🎯 **목표**: 유틸리티
-> 함수들의 프로바이더 독립화 — LlmContent 기반 provider-independent 함수 추가 🔗
-> **이전 작업**:
-> [Phase2_M2.4_ModelConfigService호환레이어\_20260208.md](./Phase2_M2.4_ModelConfigService호환레이어_20260208.md)
-> 🔗 **관련 문서**:
-> [phase2_core_refactoring_todolist.md](../todolist/phase2_core_refactoring_todolist.md) -
-> M2.5
-
----
-
-## 📋 작업 요약
-
-### 접근 전략
-
-**점진적 마이그레이션**: 기존 Gemini SDK 의존 함수를 수정하지 않고, 새로운
-provider-independent 함수를 병행 추가. 기존 함수에는 `@deprecated` 주석을
-추가하여 향후 마이그레이션을 유도.
-
-**작업 순서**: 2.5.3 (llmUtils — 의존 없음) → 2.5.1 (tokenCalculation) → 2.5.2
-(partUtils). 공통 type guard를 먼저 만들어 후속 파일에서 재사용.
-
-**타입 매핑**: 설계서의 "LlmPart"는 실제 코드베이스에서 `LlmContent` 유니온 타입
-(5개 variant)으로 구현되어 있으므로, 이를 기준으로 작업.
-
-### 2.5.3 llmUtils.ts 생성 ✅
-
-| 항목                               | 상태 | 비고                          |
-| ---------------------------------- | :--: | ----------------------------- |
-| `isTextContent()` type guard       |  ✅  | `c.type === 'text'`           |
-| `isImageContent()` type guard      |  ✅  | `c.type === 'image'`          |
-| `isToolCallContent()` type guard   |  ✅  | `c.type === 'tool_call'`      |
-| `isToolResultContent()` type guard |  ✅  | `c.type === 'tool_result'`    |
-| `isThoughtContent()` type guard    |  ✅  | `c.type === 'thought'`        |
-| `extractText(contents)` 헬퍼       |  ✅  | text content만 필터링 후 join |
-| `createTextContent(text)` 팩토리   |  ✅  | `{ type: 'text', text }` 생성 |
-
-**테스트**: 12개 (llmUtils.test.ts)
-
-### 2.5.1 tokenCalculation.ts 리팩토링 ✅
-
-| 항목                                                 | 상태 | 비고                                              |
-| ---------------------------------------------------- | :--: | ------------------------------------------------- |
-| `estimateLlmTokenCount(contents)` 추가               |  ✅  | LlmContent[] 기반 provider-independent 토큰 추정  |
-| `estimateTextTokens(text)` 내부 헬퍼 추출            |  ✅  | ASCII/CJK 문자별 가중치 + 대용량 텍스트 근사      |
-| `estimateTokenCountSync` → `estimateTextTokens` 위임 |  ✅  | 기존 함수의 텍스트 추정 로직 중복 제거 (Refactor) |
-| `estimateTokenCountSync` `@deprecated` 추가          |  ✅  | → `estimateLlmTokenCount` 사용 안내               |
-| `calculateRequestTokenCount` `@deprecated` 추가      |  ✅  | Gemini SDK-specific 명시                          |
-
-**테스트**: 19개 (tokenCalculation.test.ts — 기존 10 + 신규 9)
-
-### 2.5.2 partUtils.ts 리팩토링 ✅
-
-| 항목                                               | 상태 | 비고                                        |
-| -------------------------------------------------- | :--: | ------------------------------------------- |
-| `contentToString(content, options?)` 추가          |  ✅  | LlmContent/LlmContent[] → string 변환       |
-| `getMessageText(message)` 추가                     |  ✅  | LlmMessage에서 텍스트 추출 (thought 제외)   |
-| `flatMapLlmTextContents(contents, transform)` 추가 |  ✅  | LlmContent[] async flat-map (텍스트만 변환) |
-| `appendToLastLlmTextContent(contents, text)` 추가  |  ✅  | LlmContent[] 마지막 텍스트에 append         |
-| `partToString` `@deprecated` 추가                  |  ✅  | → `contentToString` 사용 안내               |
-| `getResponseText` `@deprecated` 추가               |  ✅  | → `getMessageText` 사용 안내                |
-| `flatMapTextParts` `@deprecated` 추가              |  ✅  | → `flatMapLlmTextContents` 사용 안내        |
-| `appendToLastTextPart` `@deprecated` 추가          |  ✅  | → `appendToLastLlmTextContent` 사용 안내    |
-
-**테스트**: 55개 (partUtils.test.ts — 기존 37 + 신규 18)
-
----
-
-## 📊 검증 결과
-
-| 검증 항목           |       결과        | 비고                                            |
-| ------------------- | :---------------: | ----------------------------------------------- |
-| 전체 테스트         | ✅ 4803/4803 pass | M2.4 최종 4764 + M2.5 신규 39 (skipped 24 별도) |
-| TypeScript 컴파일   |      ✅ 클린      | tsc --noEmit 0 errors                           |
-| ESLint              |      ✅ 통과      | pre-commit hook 통과                            |
-| 기존 기능 100% 동작 |        ✅         | 기존 테스트 전체 통과                           |
-| M2.5 대상 테스트    |   ✅ 86/86 pass   | llmUtils 12 + tokenCalc 19 + partUtils 55       |
-
----
-
-## 📁 파일 목록
-
-### 신규 생성
-
-| 파일                     | 용도                                    | LOC |
-| ------------------------ | --------------------------------------- | --- |
-| `utils/llmUtils.ts`      | Provider-independent type guards + 헬퍼 | ~72 |
-| `utils/llmUtils.test.ts` | llmUtils TDD 테스트 (12개)              | ~88 |
-
-### 수정
-
-| 파일                             | 변경 내용                                                                                                       |
-| -------------------------------- | --------------------------------------------------------------------------------------------------------------- |
-| `utils/tokenCalculation.ts`      | +estimateLlmTokenCount, +estimateTextTokens, 기존 함수 @deprecated                                              |
-| `utils/tokenCalculation.test.ts` | +estimateLlmTokenCount 테스트 9개 추가                                                                          |
-| `utils/partUtils.ts`             | +contentToString, +getMessageText, +flatMapLlmTextContents, +appendToLastLlmTextContent, 기존 4함수 @deprecated |
-| `utils/partUtils.test.ts`        | +provider-independent 함수 테스트 18개 추가                                                                     |
-
----
-
-## 🔑 핵심 설계 결정
-
-### 1. 점진적 마이그레이션 (병행 추가 + @deprecated)
-
-**문제**: partUtils.ts는 12+ 파일에서 사용 중. 시그니처 변경 시 대규모 연쇄 수정
-필요.
-
-**결정**: 기존 함수를 수정하지 않고, 새 provider-independent 함수를 병행 추가.
-기존 함수에 `@deprecated` JSDoc을 추가하여 IDE에서 경고 표시.
-
-**장점**:
-
-- 기존 코드 무변경 → 회귀 위험 0
-- 호출자가 자연스럽게 마이그레이션 가능
-- 양쪽 함수 모두 동일 파일에 있어 참조 용이
-
-### 2. type discriminator 기반 type guard
-
-**문제**: Gemini SDK의 `Part` 타입은 property-existence 체크(`'text' in part`),
-LlmContent는 discriminated union(`content.type === 'text'`).
-
-**결정**: LlmContent의 `type` 필드를 사용하는 type guard 5개를 llmUtils.ts에
-정의. 이를 tokenCalculation.ts와 partUtils.ts에서 import하여 사용.
-
-### 3. estimateTextTokens 헬퍼 추출 (Refactor)
-
-**문제**: `estimateTokenCountSync`와 `estimateLlmTokenCount`에서 텍스트 토큰
-추정 로직이 중복.
-
-**결정**: 공통 로직을 `estimateTextTokens(text: string): number`로 추출.
-`estimateTokenCountSync`를 이 헬퍼에 위임하도록 리팩토링.
-
-### 4. LlmPart → LlmContent 타입 매핑
-
-**문제**: todolist에서 "LlmPart" 타입을 참조하지만, 실제 코드베이스에는
-`LlmPart` 타입이 존재하지 않음.
-
-**결정**: `LlmContent` 유니온 타입 (LlmTextContent | LlmImageContent |
-LlmToolCallContent | LlmToolResultContent | LlmThoughtContent)을 "LlmPart"로
-간주하고 작업. todolist의 시그니처 변경 대신 신규 함수 추가 방식 채택.
-
----
-
-## ⚠️ 다음 마일스톤 이월 사항
-
-### M2.6으로 이월
-
-| 항목                                                  | 우선순위 | 비고                                  |
-| ----------------------------------------------------- | -------- | ------------------------------------- |
-| loggingContentGenerator ProviderApiResponseEvent 전환 | 중간     | M2.2에서 이월 → 이벤트 경로 전환 필요 |
-| client.ts GeminiEventType 참조 정리                   | 중간     | M2.2에서 이월                         |
-| turn.ts 이벤트 생성점 전환                            | 중간     | M2.2에서 이월                         |
-| 2.4.2 ModelRouterService 연동                         | 높음     | M2.4에서 이월                         |
-
----
-
-## 🔄 리뷰 후 수정 사항
-
-### 이슈 1 [Medium]: llmUtils.ts public API export 누락
-
-**지적 내용**: `llmUtils.ts`의 type guards 등이 `index.ts`에서 export되지 않아
-외부 패키지(cli 등)에서 접근 불가.
-
-**검증 결과**: 확인됨 — `index.ts`에 `partUtils.js`는 있으나 `llmUtils.js`
-export 없음. `tokenCalculation.ts`는 기존부터 내부 전용이므로 현행 유지.
-
-**수정 내용**:
-
-| 항목       | 변경                                                  |
-| ---------- | ----------------------------------------------------- |
-| `index.ts` | `export * from './utils/llmUtils.js'` 추가 (L85 앞에) |
-
-### 이슈 2 [Low]: getMessageText inline import type 패턴
-
-**지적 내용**: `LlmTextContent`를 inline dynamic import으로 참조. 상단 import에
-추가하는 것이 프로젝트 스타일과 일관.
-
-**검증 결과**: 확인됨 — 상단에 `LlmContent`, `LlmMessage`만 import하고
-`LlmTextContent` 누락.
-
-**수정 내용**:
-
-| 항목           | 변경                                                     |
-| -------------- | -------------------------------------------------------- |
-| `partUtils.ts` | 상단 import에 `LlmTextContent` 추가                      |
-| `partUtils.ts` | `:236` inline import → 직접 `LlmTextContent` 참조로 변경 |
-
-### 이슈 3 [Low]: 테스트 수치 기준 불일치
-
-**지적 내용**: "기존 27 + 신규 28"로 기재했으나 실제는 "기존 37 + 신규 18". 전체
-수치도 M2.4 최종(4764)과 정합하지 않음.
-
-**검증 결과**: M2.4 커밋(ef287eb0f)에서 직접 테스트 실행하여 확인.
-
-| 파일                     | M2.4 시점 | M2.5 시점 | delta   |
-| ------------------------ | --------- | --------- | ------- |
-| llmUtils.test.ts         | (없음)    | 12        | +12     |
-| tokenCalculation.test.ts | 10        | 19        | +9      |
-| partUtils.test.ts        | 37        | 55        | +18     |
-| **합계**                 |           |           | **+39** |
-
-**수정 내용**: 작업 결과서 전체 수치 정정 (49→39, 28→18, 기존 27→37).
-
-### 수정 후 검증 결과
-
-| 검증 항목         |       결과        | 비고                  |
-| ----------------- | :---------------: | --------------------- |
-| 전체 테스트       | ✅ 4803/4803 pass | M2.4(4764) + 39 신규  |
-| TypeScript 컴파일 |      ✅ 클린      | tsc --noEmit 0 errors |
-| ESLint            |      ✅ 통과      | pre-commit hook 통과  |
-
----
-
-## 📌 커밋 정보
-
-| 커밋 | 해시      | 설명                                                                            |
-| ---- | --------- | ------------------------------------------------------------------------------- |
-| feat | fcb444e46 | feat(providers): M2.5 유틸리티 레이어 리팩토링 — provider-independent 함수 추가 |
-| docs | 02eee5142 | docs: M2.5 작업 결과서 및 체크리스트 업데이트                                   |
-| fix  | 6e0f8ad13 | fix(providers): M2.5 리뷰 수정 — llmUtils export 추가 및 inline import 정리     |
-
----
-
-## ✅ 체크리스트
-
-- [x] 본작업 완료: 2.5.1 + 2.5.2 + 2.5.3
-- [x] TDD 사이클 완료: Red → Green → Refactor
-- [x] 테스트: 39개 신규 (llmUtils 12 + tokenCalc 9 + partUtils 18), 전체 4803개
-      통과
-- [x] TypeScript 컴파일: 클린
-- [x] ESLint: 통과 (pre-commit hook)
-- [x] @deprecated: 기존 6개 함수에 추가
-- [x] 중복 제거: estimateTokenCountSync → estimateTextTokens 위임
-- [x] 커밋: fcb444e46 (feat), 02eee5142 (docs)
-- [x] 작업 결과서 작성
-- [x] 리뷰 이슈 수정: [Medium] export 추가, [Low] inline import 정리, [Low] 수치
-      정정
-- [x] 리뷰 수정 후 검증: 4803/4803 tests, TS clean