@didim365/agent-cli-core 0.1.0

package/dist/docs/00_project/white_labeling/template/99_TDD_plan.md

@@ -0,0 +1,123 @@
+Appendix 1: System Prompt Always follow the instructions in plan.md. When I say
+"go", find the next unmarked test in plan.md, implement the test, then implement
+only enough code to make that test pass.
+
+# ROLE AND EXPERTISE
+
+You are a senior software engineer who follows Kent Beck's Test-Driven
+Development (TDD) and Tidy First principles. Your purpose is to guide
+development following these methodologies precisely.
+
+# CORE DEVELOPMENT PRINCIPLES
+
+- Always follow the TDD cycle: Red → Green → Refactor
+
+- Write the simplest failing test first
+
+- Implement the minimum code needed to make tests pass
+
+- Refactor only after tests are passing
+
+- Follow Beck's "Tidy First" approach by separating structural changes from
+  behavioral changes
+
+- Maintain high code quality throughout development
+
+# TDD METHODOLOGY GUIDANCE
+
+- Start by writing a failing test that defines a small increment of
+  functionality
+
+- Use meaningful test names that describe behavior (e.g.,
+  "shouldSumTwoPositiveNumbers")
+
+- Make test failures clear and informative
+
+- Write just enough code to make the test pass - no more
+
+- Once tests pass, consider if refactoring is needed
+
+- Repeat the cycle for new functionality
+
+# TIDY FIRST APPROACH
+
+- Separate all changes into two distinct types:
+
+1. STRUCTURAL CHANGES: Rearranging code without changing behavior (renaming,
+   extracting methods, moving code)
+
+2. BEHAVIORAL CHANGES: Adding or modifying actual functionality
+
+- Never mix structural and behavioral changes in the same commit
+
+- Always make structural changes first when both are needed
+
+- Validate structural changes do not alter behavior by running tests before and
+  after
+
+# COMMIT DISCIPLINE
+
+- Only commit when:
+
+1. ALL tests are passing
+
+2. ALL compiler/linter warnings have been resolved
+
+3. The change represents a single logical unit of work
+
+4. Commit messages clearly state whether the commit contains structural or
+   behavioral changes
+
+- Use small, frequent commits rather than large, infrequent ones
+
+# CODE QUALITY STANDARDS
+
+- Eliminate duplication ruthlessly
+
+- Express intent clearly through naming and structure
+
+- Make dependencies explicit
+
+- Keep methods small and focused on a single responsibility
+
+- Minimize state and side effects
+
+- Use the simplest solution that could possibly work
+
+# REFACTORING GUIDELINES
+
+- Refactor only when tests are passing (in the "Green" phase)
+
+- Use established refactoring patterns with their proper names
+
+- Make one refactoring change at a time
+
+- Run tests after each refactoring step
+
+- Prioritize refactorings that remove duplication or improve clarity
+
+# EXAMPLE WORKFLOW
+
+When approaching a new feature:
+
+1. Write a simple failing test for a small part of the feature
+
+2. Implement the bare minimum to make it pass
+
+3. Run tests to confirm they pass (Green)
+
+4. Make any necessary structural changes (Tidy First), running tests after each
+   change
+
+5. Commit structural changes separately
+
+6. Add another test for the next small increment of functionality
+
+7. Repeat until the feature is complete, committing behavioral changes
+   separately from structural ones
+
+Follow this process precisely, always prioritizing clean, well-tested code over
+quick implementation.
+
+Always write one test at a time, make it run, then improve structure. Always run
+all the tests (except long-running tests) each time.

package/dist/docs/00_project/white_labeling/todolist/Phase_CLI/355/214/250/355/202/244/354/247/200/353/252/205/353/263/200/352/262/275_todolist.md

@@ -0,0 +1,431 @@
+# CLI 배포 패키지명 변경 작업 계획서
+
+> **TDD 방법론 기반**: Red → Green → Refactor 사이클 적용 **작업 원칙**: 테스트
+> 먼저 작성 → 최소 코드 구현 → 리팩터링 **Tidy First**: 구조적 변경(이름 변경)과
+> 동작 변경 분리 **참고 문서**: [99_TDD_plan.md](../template/99_TDD_plan.md)
+> **버전**: v1.0
+
+---
+
+## 📋 작업 개요
+
+| 항목        | 내용                                                                      |
+| ----------- | ------------------------------------------------------------------------- |
+| 프로젝트    | CLI 배포 패키지명을 `@google/gemini-cli` → `@didim365/agent-cli`로 변경      |
+| 영향 범위   | 26개 파일, 77개 참조 (package.json, scripts, docs, source, tests)         |
+| 위험 수준   | 🟡 Medium (문자열 치환 중심이나, tgz 파일명/npm 워크스페이스 연동에 주의) |
+| 성능 민감도 | 🟢 Low (런타임 성능 무관)                                                 |
+| 작업 브랜치 | `DID/v0.1` (현재 브랜치)                                                  |
+
+---
+
+## 🚨 핵심 리스크 요약
+
+| 리스크                                | 영향      | 대응 방안                                      | 상태 |
+| ------------------------------------- | --------- | ---------------------------------------------- | ---- |
+| tgz 파일명 변경 누락                  | 🟠 Medium | `npm pack` 출력 파일명 패턴도 함께 변경        | ⬜   |
+| npm workspace 참조 깨짐               | 🟠 Medium | root package.json + package-lock.json 재생성   | ⬜   |
+| ESLint no-restricted-imports 미동기화 | 🟢 Low    | eslint.config.js의 패키지명도 함께 변경        | ⬜   |
+| 소스 코드 내 update 명령 하드코딩     | 🟠 Medium | installationInfo.ts의 4곳 + 테스트 18곳 동기화 | ⬜   |
+
+---
+
+## 📊 영향 범위 상세
+
+### 카테고리별 파일 목록
+
+**A. 패키지 정의 (3 files)**
+
+- `package.json` (root, line 2) — 루트 패키지명
+- `packages/cli/package.json` (line 2) — CLI 패키지명 (핵심)
+- `package-lock.json` — 재생성 필요
+
+**B. 빌드/릴리스 스크립트 (6 files)**
+
+- `scripts/build_sandbox.js` (lines 93, 95, 97, 118) — pack 명령 + tgz 파일명
+- `scripts/get-release-version.js` (lines 42, 44) — 패키지명 기본값
+- `scripts/releasing/create-patch-pr.js` (lines 35, 37) — 패키지명 기본값
+- `scripts/releasing/patch-comment.js` (line 143) — npm install 문구
+- `scripts/prepare-github-release.js` (lines 42, 44) — GitHub 패키징용 이름
+- `scripts/tests/get-release-version.test.js` (lines 60, 130, 171, 178) — 테스트
+
+**C. ESLint 설정 (1 file)**
+
+- `eslint.config.js` (lines 228-229) — no-restricted-imports 규칙
+
+**D. 소스 코드 (1 file)**
+
+- `packages/cli/src/utils/installationInfo.ts` (lines 113, 126, 146, 179) —
+  업데이트 명령
+
+**E. 소스 테스트 (2 files)**
+
+- `packages/cli/src/utils/installationInfo.test.ts` (7 occurrences)
+- `packages/cli/src/utils/handleAutoUpdate.test.ts` (11 occurrences)
+
+**F. 문서 (13 files)**
+
+- `README.md` (5 occurrences)
+- `docs/npm.md` (5), `docs/releases.md` (9), `docs/release-confidence.md` (4)
+- `docs/get-started/installation.md` (2), `docs/get-started/gemini-3.md` (1)
+- `docs/changelogs/preview.md` (1), `docs/changelogs/index.md` (1)
+- `docs/troubleshooting.md` (1), `docs/faq.md` (1), `docs/cli/uninstall.md` (1)
+- `docs/change_model/model_command_multi_provider_plan.md` (1)
+- `docs/change_model/model_command_multi_provider_todolist.md` (2)
+- `docs/00_project/ai_adapter/working_history/Phase3_ETC_...` (2)
+
+---
+
+## 🔄 Phase 1: 소스 코드 + 테스트 변경
+
+> 소스 코드(`installationInfo.ts`)와 테스트에서 `@google/gemini-cli`를
+> `@didim365/agent-cli`로 변경
+
+### 1.1 사전 작업 (Pre-Work)
+
+- [ ] **[CONTEXT]** 작업 목적 및 배경 확인
+  - `@google/gemini-cli`로 설치되는 패키지를 `@didim365/agent-cli`로 변경하여 독립
+    브랜딩
+  - `@didim365/agent-cli-core`, `@google/gemini-cli-a2a-server`는 변경하지 않음
+
+- [ ] **[ANALYSIS]** 현재 소스 코드 참조 분석
+  - `packages/cli/src/utils/installationInfo.ts` — 4곳 (pnpm/yarn/bun/npm update
+    명령)
+  - `packages/cli/src/utils/installationInfo.test.ts` — 7곳
+  - `packages/cli/src/utils/handleAutoUpdate.test.ts` — 11곳
+
+### 1.2 🔴 RED Phase: 기존 테스트 실패 확인
+
+- [ ] **[RED]** 현재 테스트 기준선 확인
+
+  ```bash
+  npm test -w @google/gemini-cli -- src/utils/installationInfo.test.ts src/utils/handleAutoUpdate.test.ts
+  ```
+  - 현재 상태에서 모든 테스트가 PASS함을 기록 (변경 전 기준선)
+
+- [ ] **[RED-VERIFY]** `installationInfo.ts`의 패키지명 변경 후 테스트 실패 확인
+  - `installationInfo.ts`만 변경 → 관련 테스트에서 기대값 불일치로 FAIL 확인
+
+### 1.3 🟢 GREEN Phase: 테스트 + 소스 동기화
+
+- [ ] **[TASK-001]** `installationInfo.ts` 패키지명 변경
+  - 파일: `packages/cli/src/utils/installationInfo.ts`
+  - 변경: `@google/gemini-cli` → `@didim365/agent-cli` (4곳)
+    - Line 113: `pnpm add -g @didim365/agent-cli@latest`
+    - Line 126: `yarn global add @didim365/agent-cli@latest`
+    - Line 146: `bun add -g @didim365/agent-cli@latest`
+    - Line 179: `npm install -g @didim365/agent-cli@latest`
+
+- [ ] **[TASK-002]** `installationInfo.test.ts` 기대값 변경
+  - 파일: `packages/cli/src/utils/installationInfo.test.ts`
+  - 변경: `@google/gemini-cli` → `@didim365/agent-cli` (7곳)
+
+- [ ] **[TASK-003]** `handleAutoUpdate.test.ts` 기대값 변경
+  - 파일: `packages/cli/src/utils/handleAutoUpdate.test.ts`
+  - 변경: `@google/gemini-cli` → `@didim365/agent-cli` (11곳)
+
+- [ ] **[GREEN-VERIFY]** 테스트 통과 확인
+  ```bash
+  npm test -w @google/gemini-cli -- src/utils/installationInfo.test.ts src/utils/handleAutoUpdate.test.ts
+  ```
+
+### 1.4 🔵 REFACTOR Phase
+
+- [ ] **[REFACTOR-STRUCTURE]** 하드코딩 패키지명을 상수로 추출 검토
+  - 현재 4곳에 `@didim365/agent-cli` 하드코딩 — 상수 추출 여부 판단
+  - 기존 패턴이 하드코딩이므로, 일관성 유지 차원에서 유지 (선택)
+
+- [ ] **[REFACTOR-VERIFY]** 테스트 재확인
+  ```bash
+  npm test -w @google/gemini-cli -- src/utils/installationInfo.test.ts src/utils/handleAutoUpdate.test.ts
+  ```
+
+### 1.5 사후 작업 (Post-Work)
+
+- [ ] **[LINT]** 린터 검사
+
+  ```bash
+  npm run lint -w @google/gemini-cli
+  ```
+
+- [ ] **[COMMIT]** 변경사항 커밋
+  ```bash
+  git commit -m "feat(cli): 설치/업데이트 명령 패키지명 @didim365/agent-cli로 변경"
+  ```
+
+---
+
+## 🔄 Phase 2: 패키지 정의 + 빌드 스크립트 변경
+
+> package.json, build scripts, ESLint 설정의 패키지명 변경
+
+### 2.1 사전 작업
+
+- [ ] **[REVIEW]** Phase 1 완료 확인
+- [ ] **[ANALYSIS]** tgz 파일명 패턴 확인
+  - `npm pack`은 패키지명에서 `@scope/name` → `scope-name-version.tgz` 형식 생성
+  - `@didim365/agent-cli` → `didim365-agent-cli-{version}.tgz`
+
+### 2.2 🔴 RED Phase
+
+- [ ] **[RED]** 빌드 스크립트 테스트 기준선 확인
+  ```bash
+  npx vitest run --config scripts/tests/vitest.config.ts scripts/tests/get-release-version.test.js
+  ```
+
+### 2.3 🟢 GREEN Phase
+
+- [ ] **[TASK-001]** `packages/cli/package.json` name 변경
+  - Line 2: `"name": "@google/gemini-cli"` → `"name": "@didim365/agent-cli"`
+  - `publishConfig` 추가:
+    ```json
+    "publishConfig": {
+      "access": "public"
+    }
+    ```
+
+- [ ] **[TASK-002]** `package.json` (root) name 변경
+  - Line 2: `"name": "@google/gemini-cli"` → `"name": "@didim365/agent-cli"`
+
+- [ ] **[TASK-003]** `scripts/build_sandbox.js` 변경
+  - Line 93: 로그 메시지 `@didim365/agent-cli`
+  - Line 95: rmSync glob `didim365-agent-cli-*.tgz`
+  - Line 97: `npm pack -w @didim365/agent-cli`
+  - Line 118: chmodSync `didim365-agent-cli-${packageVersion}.tgz`
+
+- [ ] **[TASK-004]** `scripts/get-release-version.js` 변경
+  - Lines 42, 44: 패키지명 기본값 `@didim365/agent-cli`
+
+- [ ] **[TASK-005]** `scripts/releasing/create-patch-pr.js` 변경
+  - Lines 35, 37: 패키지명 기본값 `@didim365/agent-cli`
+
+- [ ] **[TASK-006]** `scripts/releasing/patch-comment.js` 변경
+  - Line 143: npm install 문구 `@didim365/agent-cli`
+
+- [ ] **[TASK-007]** `scripts/prepare-github-release.js` 변경
+  - Line 42: 주석 `@didim365/agent-cli`
+  - Line 44: `pkg.name = '@didim365/agent-cli'` (GitHub 패키징용)
+
+- [ ] **[TASK-008]** `scripts/tests/get-release-version.test.js` 변경
+  - Lines 60, 130, 171, 178: `@didim365/agent-cli`
+
+- [ ] **[TASK-009]** `eslint.config.js` 변경
+  - Lines 228-229: no-restricted-imports 패키지명 `@didim365/agent-cli`
+
+- [ ] **[GREEN-VERIFY]** 빌드 및 테스트 확인
+  ```bash
+  npm install  # package-lock.json 재생성
+  npm run build -w @didim365/agent-cli
+  npm run typecheck -w @didim365/agent-cli
+  npm run lint
+  ```
+
+### 2.4 🔵 REFACTOR Phase
+
+- [ ] **[REFACTOR-STRUCTURE]** package-lock.json 재생성 정리
+
+  ```bash
+  rm package-lock.json && npm install
+  ```
+
+- [ ] **[REFACTOR-VERIFY]** 전체 빌드 재확인
+  ```bash
+  npm run build
+  npm test -w @didim365/agent-cli
+  ```
+
+### 2.5 사후 작업
+
+- [ ] **[TEST]** Phase 1 테스트 회귀 확인 (workspace명 변경 반영)
+
+  ```bash
+  npm test -w @didim365/agent-cli -- src/utils/installationInfo.test.ts src/utils/handleAutoUpdate.test.ts
+  ```
+
+- [ ] **[VERIFY]** npm pack 파일명 확인
+
+  ```bash
+  npm pack -w @didim365/agent-cli --dry-run  # didim365-agent-cli-{ver}.tgz 확인
+  ```
+
+- [ ] **[COMMIT]** 변경사항 커밋
+  ```bash
+  git commit -m "feat(cli): 패키지명 @didim365/agent-cli로 변경 + 빌드 스크립트 동기화"
+  ```
+
+---
+
+## 🔄 Phase 3: 문서 일괄 변경
+
+> README, docs/ 내 모든 `@google/gemini-cli` 참조를 `@didim365/agent-cli`로 변경
+
+### 3.1 사전 작업
+
+- [ ] **[REVIEW]** Phase 2 완료 확인 (빌드 성공)
+- [ ] **[ANALYSIS]** 변경 대상 문서 목록 (13 files, ~35 occurrences)
+
+### 3.2 🔴 RED Phase
+
+> 문서는 TDD 대상이 아니므로, 변경 전 영향 범위 확인으로 대체
+
+- [ ] **[RED]** 변경 전 grep 기준선 기록
+  ```bash
+  grep -r "@google/gemini-cli" docs/ README.md --include="*.md" | grep -v "gemini-cli-core" | grep -v "gemini-cli-a2a" | wc -l
+  ```
+
+### 3.3 🟢 GREEN Phase
+
+- [ ] **[TASK-001]** `README.md` 변경 (5곳)
+- [ ] **[TASK-002]** `docs/npm.md` 변경 (5곳)
+- [ ] **[TASK-003]** `docs/releases.md` 변경 (9곳)
+- [ ] **[TASK-004]** `docs/release-confidence.md` 변경 (4곳)
+- [ ] **[TASK-005]** `docs/get-started/installation.md` 변경 (2곳)
+- [ ] **[TASK-006]** `docs/get-started/gemini-3.md` 변경 (1곳)
+- [ ] **[TASK-007]** `docs/changelogs/preview.md` 변경 (1곳)
+- [ ] **[TASK-008]** `docs/changelogs/index.md` 변경 (1곳)
+- [ ] **[TASK-009]** `docs/troubleshooting.md` 변경 (1곳)
+- [ ] **[TASK-010]** `docs/faq.md` 변경 (1곳)
+- [ ] **[TASK-011]** `docs/cli/uninstall.md` 변경 (1곳)
+- [ ] **[TASK-012]** `docs/change_model/*.md` 변경 (3곳)
+- [ ] **[TASK-013]** `docs/00_project/ai_adapter/working_history/...` 변경 (2곳)
+
+- [ ] **[GREEN-VERIFY]** 변경 후 잔존 참조 확인
+  ```bash
+  grep -r "@google/gemini-cli" docs/ README.md --include="*.md" | grep -v "gemini-cli-core" | grep -v "gemini-cli-a2a"
+  # 결과: 0건이어야 함
+  ```
+
+### 3.4 🔵 REFACTOR Phase
+
+- [ ] **[REFACTOR-STRUCTURE]** 문구 일관성 확인
+  - `npm install -g @didim365/agent-cli` 형태 통일
+  - 불필요한 Google NPM 뱃지 URL 검토
+
+### 3.5 사후 작업
+
+- [ ] **[VERIFY]** 문서 빌드 확인 (있는 경우)
+- [ ] **[COMMIT]** 변경사항 커밋
+  ```bash
+  git commit -m "docs: 설치/릴리스 문서 패키지명 @didim365/agent-cli로 변경"
+  ```
+
+---
+
+## 🔄 Phase 4: 통합 검증 + 락파일 재생성
+
+> 전체 빌드/테스트/린트 통합 검증 및 최종 정리
+
+### 4.1 사전 작업
+
+- [ ] **[REVIEW]** Phase 1~3 완료 확인
+
+### 4.2 🟢 GREEN Phase (통합 검증)
+
+- [ ] **[TASK-001]** package-lock.json 최종 재생성
+
+  ```bash
+  rm package-lock.json && npm install
+  ```
+
+- [ ] **[TASK-002]** 전체 빌드
+
+  ```bash
+  npm run build
+  ```
+
+- [ ] **[TASK-003]** 전체 테스트
+
+  ```bash
+  npm test -w @didim365/agent-cli
+  npm test -w @didim365/agent-cli-core
+  npm test -w @google/gemini-cli-a2a-server
+  ```
+
+- [ ] **[TASK-004]** 린트 + 타입체크
+
+  ```bash
+  npm run lint
+  npm run typecheck
+  ```
+
+- [ ] **[TASK-005]** 잔존 참조 최종 확인
+  ```bash
+  grep -r "@google/gemini-cli" . --include="*.ts" --include="*.tsx" --include="*.js" --include="*.json" --include="*.md" | grep -v node_modules | grep -v "gemini-cli-core" | grep -v "gemini-cli-a2a" | grep -v package-lock.json
+  # 결과: 0건이어야 함 (package-lock은 npm install이 처리)
+  ```
+
+### 4.3 사후 작업
+
+- [ ] **[DOC]** 작업 결과서 작성
+  - 파일:
+    `docs/00_project/white_labeling/working_history/Phase_패키지명변경_{작업일자}.md`
+
+- [ ] **[COMMIT]** 최종 커밋
+  ```bash
+  git commit -m "chore: package-lock.json 재생성 (패키지명 변경 반영)"
+  ```
+
+---
+
+## ✅ 최종 체크리스트
+
+### TDD 사이클 완료
+
+- [x] Phase 1: 소스 코드 + 테스트 변경 완료
+- [x] Phase 2: 패키지 정의 + 빌드 스크립트 변경 완료
+- [x] Phase 3: 문서 일괄 변경 완료
+- [x] Phase 4: 통합 검증 + 락파일 재생성 완료
+- [x] 전체 테스트 통과 (변경 관련 36/36, 전체 timeout만 기존 flaky)
+- [x] 린터 경고 0개
+- [x] 잔존 `@google/gemini-cli` 참조 0건 (소스/설정 기준)
+
+### 퍼블리시 준비 (별도)
+
+- [ ] `@didim` npm scope 생성/권한 확인
+- [ ] `npm publish --access public` 설정 확인
+- [ ] `publishConfig.access: "public"` 추가 확인
+
+### Phase 완료 조건
+
+| Phase   | 🔴 Red | 🟢 Green | 🔵 Refactor | 결과서 | 커밋 | 상태 |
+| ------- | ------ | -------- | ----------- | ------ | ---- | ---- |
+| Phase 1 | ✅     | ✅       | ✅          | ✅     | ⬜   | ✅   |
+| Phase 2 | ✅     | ✅       | ✅          | ✅     | ⬜   | ✅   |
+| Phase 3 | ✅     | ✅       | ✅          | ✅     | ⬜   | ✅   |
+| Phase 4 | -      | ✅       | -           | ✅     | ⬜   | ✅   |
+
+---
+
+## ⚠️ 주의사항
+
+### 변경 범위 제한
+
+1. **`@google/gemini-cli`만 변경** — `@didim365/agent-cli-core`,
+   `@google/gemini-cli-a2a-server`는 변경하지 않음
+2. **tgz 파일명 패턴**: `@didim365/agent-cli` → `didim365-agent-cli-{ver}.tgz` (npm
+   규칙)
+3. **workspace 참조**: Phase 2 이후 `npm test -w` 명령에서 workspace 이름이
+   `@didim365/agent-cli`로 변경됨
+4. **prepare-github-release.js**: GitHub Packages 사용 시 scope 검토 필요
+
+### TDD 사이클 원칙
+
+1. **Red First**: Phase 1에서 소스 변경 시 테스트 실패 확인 후 테스트 동기화
+2. **Minimal Green**: 문자열 치환만 수행, 구조 변경 없음
+3. **Safe Refactor**: 테스트가 통과하는 상태에서만 리팩터링 진행
+
+---
+
+## 📅 예상 일정
+
+| Phase     | 예상 소요 | 비고                                          |
+| --------- | --------- | --------------------------------------------- |
+| Phase 1   | 15분      | 소스 + 테스트 3개 파일                        |
+| Phase 2   | 20분      | 패키지 정의 + 스크립트 9개 파일 + lock 재생성 |
+| Phase 3   | 15분      | 문서 13개 파일 일괄 치환                      |
+| Phase 4   | 10분      | 통합 검증                                     |
+| **Total** | **~60분** | -                                             |
+
+---
+
+**작성일**: 2026-02-14 **상태**: 🔄 작업 진행 중