tylersong 1.0.9 → 1.0.11

package/.cursor/plans/-----------8c733d2f.plan.md

@@ -0,0 +1,158 @@
+<!-- 8c733d2f-63d8-4158-aa6e-255c23deedca 77c7f805-6518-4181-90b0-4dff17016b38 -->
+# 프로젝트 품질 개선 계획
+
+## 📊 현재 프로젝트 분석
+
+### ✅ 장점
+
+1. **깔끔한 코드 구조**: TypeScript 기반의 명확한 단일 파일 구조
+2. **타입 안정성**: TypeScript 사용으로 인터페이스 정의 및 strict 모드 활성화
+3. **Bun 지원**: 최신 런타임 지원으로 성능 최적화 가능
+4. **풍부한 문서화**: docs 폴더에 배포, 사용법 등 상세 문서 작성됨
+5. **사용자 친화적**: Commander.js, Inquirer.js로 직관적인 CLI 경험 제공
+6. **크로스 플랫폼**: Windows, macOS, Linux 모두 지원하는 URL 열기 기능
+
+### ❌ 단점 및 개선 필요 사항
+
+#### 1. **테스트 코드 부재** (Critical)
+
+- 현재 `package.json`에 "No test specified"로 테스트 미구현
+- 사용자 규칙에 따라 Vitest 사용 필요
+
+#### 2. **에러 처리 부족** (High)
+
+- `exec()` 함수의 에러 핸들링 없음
+- URL 열기 실패 시 사용자 피드백 없음
+- 프로미스 거부(rejection) 처리가 `.catch(console.error)`로만 처리
+
+#### 3. **린팅/포맷팅 설정 없음** (Medium)
+
+- ESLint, Prettier 등 코드 품질 도구 미설정
+- 일관된 코드 스타일 관리 어려움
+
+#### 4. **CI/CD 파이프라인 없음** (High)
+
+- docs에 워크플로우 문서는 있으나 실제 `.github/workflows` 폴더 없음
+- 자동 테스트, 빌드, 배포 검증 불가
+
+#### 5. **버전 중복 관리** (Low)
+
+- `package.json`과 `src/index.ts`에 버전이 각각 하드코딩됨
+- 버전 업데이트 시 두 곳을 수정해야 함
+
+#### 6. **Bun 우선 정책 미준수** (Medium)
+
+- `prepublishOnly` 스크립트가 `npm run build` 사용
+- 사용자 규칙에 따라 bun 사용 필요
+
+#### 7. **Git 관리 개선 필요** (Low)
+
+- `.gitignore`에 `dist/`, `*.log` 등 명시 필요
+- `node_modules` 제외 확인 필요
+
+#### 8. **보안 및 의존성 관리** (Medium)
+
+- 의존성 취약점 자동 검사 없음
+- 정기적인 업데이트 메커니즘 부재
+
+#### 9. **환경별 설정 분리 없음** (Low)
+
+- 개인정보(GitHub URL, 이메일)가 하드코딩됨
+- 설정 파일로 분리하면 재사용성 향상
+
+## 🔧 개선 작업 항목
+
+### 1. 테스트 환경 구축 (`test/` 폴더)
+
+- **파일**: `test/index.test.ts`
+- Vitest 설치 및 설정
+- 주요 함수(`openUrl`, `main`) 단위 테스트 작성
+- CLI 옵션별 통합 테스트 작성
+
+### 2. 에러 처리 강화 (`src/index.ts`)
+
+```typescript
+// openUrl 함수 개선
+const openUrl = (url: string): void => {
+  exec(`${command} ${url}`, (error) => {
+    if (error) {
+      console.error(chalk.red('❌ 브라우저를 열 수 없습니다.'));
+    }
+  });
+};
+```
+
+### 3. 린팅/포맷팅 설정
+
+- **파일**: `.eslintrc.json`, `.prettierrc`, `.editorconfig`
+- ESLint + TypeScript 플러그인 설치
+- Prettier 설정
+- pre-commit 훅 설정 (husky)
+
+### 4. CI/CD 파이프라인 구축
+
+- **파일**: `.github/workflows/ci.yml`, `.github/workflows/publish.yml`
+- Pull Request 시 자동 테스트/린트
+- main 브랜치 머지 시 자동 빌드 검증
+- 태그 푸시 시 NPM 자동 배포
+
+### 5. 버전 관리 개선
+
+- `src/index.ts`에서 버전 하드코딩 제거
+- `package.json` 버전을 동적으로 읽어오기
+
+### 6. 프로젝트 설정 개선
+
+- **파일**: `.gitignore`, `vitest.config.ts`
+- Bun 우선 스크립트 수정
+- Git ignore 규칙 추가
+
+### 7. 문서 업데이트
+
+- **파일**: `docs/testing.md`, `docs/development.md`
+- 테스트 실행 방법 문서화
+- 개발 환경 설정 가이드 추가
+- 파이프라인 다이어그램 (Mermaid 그래프)
+
+## 📝 생성/수정될 파일 목록
+
+### 새로 생성
+
+- `test/index.test.ts` - 테스트 코드
+- `vitest.config.ts` - Vitest 설정
+- `.eslintrc.json` - ESLint 설정
+- `.prettierrc` - Prettier 설정
+- `.gitignore` - Git ignore 규칙
+- `.github/workflows/ci.yml` - CI 워크플로우
+- `.github/workflows/publish.yml` - 배포 워크플로우
+- `docs/testing.md` - 테스트 가이드
+- `docs/pipeline.md` - CI/CD 파이프라인 설명 (Mermaid 그래프 포함)
+
+### 수정
+
+- `src/index.ts` - 에러 처리 강화, 버전 동적 로딩
+- `package.json` - 테스트 스크립트 추가, bun 우선 스크립트 수정
+- `README.md` - 테스트, 린팅 배지 추가
+
+## 🎯 우선순위
+
+1. **테스트 환경 구축** (가장 중요)
+2. **에러 처리 강화**
+3. **CI/CD 파이프라인**
+4. **린팅/포맷팅 설정**
+5. **기타 개선 사항**
+
+### To-dos
+
+- [ ] Vitest 설치 및 설정 파일 생성 (vitest.config.ts)
+- [ ] test/index.test.ts 파일 작성 (주요 기능 테스트)
+- [ ] src/index.ts의 에러 처리 강화 (openUrl, main 함수)
+- [ ] ESLint, Prettier 설정 파일 생성
+- [ ] .github/workflows/ci.yml 생성 (테스트, 린트 자동화)
+- [ ] .github/workflows/publish.yml 생성 (NPM 자동 배포)
+- [ ] src/index.ts에서 버전을 package.json에서 동적으로 읽어오기
+- [ ] .gitignore 파일 생성 또는 개선
+- [ ] package.json의 테스트/린트 스크립트 추가, bun 우선 수정
+- [ ] docs/testing.md 문서 작성
+- [ ] docs/pipeline.md 작성 (Mermaid 그래프 포함)
+- [ ] README.md에 테스트, 린팅 배지 및 정보 추가

package/.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.{ts,js,json}]
+indent_style = space
+indent_size = 2
+
+[*.md]
+trim_trailing_whitespace = false
+

package/.eslintrc.json

@@ -0,0 +1,33 @@
+{
+  "env": {
+    "node": true,
+    "es2021": true
+  },
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:@typescript-eslint/recommended-requiring-type-checking"
+  ],
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": "latest",
+    "sourceType": "module",
+    "project": "./tsconfig.eslint.json"
+  },
+  "plugins": ["@typescript-eslint"],
+  "rules": {
+    "@typescript-eslint/no-unused-vars": [
+      "error",
+      {
+        "argsIgnorePattern": "^_",
+        "varsIgnorePattern": "^_"
+      }
+    ],
+    "@typescript-eslint/explicit-function-return-type": "warn",
+    "@typescript-eslint/no-explicit-any": "warn",
+    "@typescript-eslint/no-floating-promises": "error",
+    "no-console": "off"
+  },
+  "ignorePatterns": ["dist", "node_modules", "*.config.ts", "*.config.js", "**/*.d.ts"]
+}
+

package/.github/workflows/ci.yml

@@ -7,39 +7,73 @@ on:
     branches: [main, develop]
 
 jobs:
-  # 간소화된 CI - 핵심 검증만
-  ci:
-    name: Lint & Test
+  test:
+    name: Test & Lint
     runs-on: ubuntu-latest
-    
+
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x]
+
     steps:
-      - name: Checkout
+      - name: 코드 체크아웃
         uses: actions/checkout@v4
 
-      - name: Setup Node.js
-        uses: actions/setup-node@v4
+      - name: Bun 설치
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: 의존성 캐시
+        uses: actions/cache@v3
         with:
-          node-version: "20.x"
-          cache: "npm"
+          path: ~/.bun/install/cache
+          key: ${{ runner.os }}-bun-${{ hashFiles('**/bun.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-bun-
 
-      - name: Install
-        run: npm ci
+      - name: 의존성 설치
+        run: bun install
 
-      - name: Type check
-        run: npx tsc --noEmit
+      - name: 타입 체크
+        run: bun run build
 
-      - name: Build
-        run: npm run build
+      - name: 린트 실행
+        run: bun run lint
 
-      - name: Test CLI
-        run: |
-          node dist/index.js --version
-          node dist/index.js --help
+      - name: 테스트 실행
+        run: bun run test
 
-      - name: Security audit
-        run: npm audit --audit-level=moderate || true
+      - name: 테스트 커버리지 업로드
+        if: matrix.node-version == '20.x'
+        uses: codecov/codecov-action@v3
+        with:
+          files: ./coverage/coverage-final.json
+          flags: unittests
+          name: codecov-umbrella
+
+  build:
+    name: Build
+    runs-on: ubuntu-latest
+    needs: test
 
-      - name: Results
-        run: |
-          echo "✅ All CI checks passed!"
-          echo "📦 Ready for deployment"
+    steps:
+      - name: 코드 체크아웃
+        uses: actions/checkout@v4
+
+      - name: Bun 설치
+        uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: 의존성 설치
+        run: bun install
+
+      - name: Bun으로 빌드
+        run: bun run build:bun
+
+      - name: 빌드 결과물 업로드
+        uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/

package/.github/workflows/deploy.yml

@@ -16,7 +16,7 @@ jobs:
   deploy:
     name: CI & Deploy
     runs-on: ubuntu-latest
-    
+
     steps:
       # === 기본 Setup ===
       - name: Checkout
@@ -57,12 +57,12 @@ jobs:
           # Git 설정
           git config user.name "github-actions[bot]"
           git config user.email "github-actions[bot]@users.noreply.github.com"
-          
+
           CURRENT_VERSION=$(node -p "require('./package.json').version")
           PUBLISHED_VERSION=$(npm view tylersong version 2>/dev/null || echo "0.0.0")
-          
+
           echo "📦 Current: $CURRENT_VERSION | Published: $PUBLISHED_VERSION"
-          
+
           # 같은 버전이면 자동 업데이트
           if [ "$CURRENT_VERSION" == "$PUBLISHED_VERSION" ]; then
             echo "🔄 Auto-updating version..."
@@ -83,12 +83,6 @@ jobs:
             npm version $VERSION_TYPE --no-git-tag-version
             NEW_VERSION=$(node -p "require('./package.json').version")
             
-            # 소스코드 버전 업데이트
-            if [ -f "src/index.ts" ]; then
-              sed -i.bak "s/program\.version(\".*\")/program.version(\"$NEW_VERSION\")/g" src/index.ts
-              rm -f src/index.ts.bak
-            fi
-            
             echo "✅ Updated to v$NEW_VERSION"
             echo "NEW_VERSION=$NEW_VERSION" >> $GITHUB_ENV
             
@@ -96,7 +90,7 @@ jobs:
             npm run build
             
             # 커밋 & 푸시
-            git add package.json package-lock.json src/index.ts dist/
+            git add package.json package-lock.json
             git commit -m "chore: bump version to v$NEW_VERSION [skip ci]"
             git push origin main
             
@@ -134,7 +128,7 @@ jobs:
           script: |
             const version = process.env.NEW_VERSION;
             const tagName = context.ref.replace('refs/tags/', '');
-            
+
             await github.rest.repos.createRelease({
               owner: context.repo.owner,
               repo: context.repo.repo,
@@ -167,4 +161,4 @@ jobs:
         run: |
           echo "❌ Deployment failed!"
           echo "📋 Check the logs above for details"
-          exit 1
+          exit 1