tylersong 1.0.11 → 1.0.13

package/docs/direct-deployment.md

@@ -1,116 +0,0 @@
-# NPM 직접 배포 가이드
-
-## 🎯 개요
-
-이 문서는 GitHub Actions 태그 자동화 없이 NPM에 직접 배포하는 방법을 설명합니다.
-
-## 📋 사전 준비사항
-
-- NPM 계정 및 로그인
-- TypeScript 프로젝트 빌드 환경
-- 적절한 권한(패키지 소유자 또는 메인테이너)
-
-## 🚀 배포 단계
-
-### 1. 버전 업데이트
-
-```bash
-# 패치 버전 자동 증가 (1.0.4 → 1.0.5)
-npm version patch
-
-# 또는 마이너 버전 증가 (1.0.4 → 1.1.0)
-npm version minor
-
-# 또는 메이저 버전 증가 (1.0.4 → 2.0.0)
-npm version major
-```
-
-### 2. TypeScript 소스 코드 수정
-
-버전이 하드코딩된 경우 소스코드도 업데이트:
-
-```typescript
-// src/index.ts
-program.version("1.0.5").description("송민성의 개발자 프로필 CLI");
-```
-
-### 3. 프로젝트 빌드
-
-```bash
-# TypeScript 컴파일
-npm run build
-```
-
-### 4. NPM 로그인 확인
-
-```bash
-# 현재 로그인 상태 확인
-npm whoami
-
-# 로그인되지 않은 경우 로그인
-npm login
-```
-
-### 5. NPM 배포
-
-```bash
-# 패키지 배포
-npm publish
-```
-
-## ✅ 배포 성공 확인
-
-### 배포된 패키지 정보 확인
-
-```bash
-# 최신 버전 정보 확인
-npm view tylersong
-
-# 모든 버전 목록 확인
-npm view tylersong versions --json
-```
-
-### 패키지 설치 및 테스트
-
-```bash
-# 전역 설치
-npm install -g tylersong@latest
-
-# 실행 테스트
-tylersong
-```
-
-## 📦 배포 결과 (2024.08.04)
-
-### 성공적으로 배포된 버전: `1.0.5`
-
-- **배포 시간**: 방금 전 (just now)
-- **패키지 크기**: 21.0 kB
-- **압축 해제 크기**: 58.1 kB
-- **포함된 파일**: 19개
-- **메인테이너**: miiinsseong <wsc7202@gmail.com>
-
-### 전체 버전 히스토리
-
-```json
-["1.0.0", "1.0.1", "1.0.3", "1.0.4", "1.0.5"]
-```
-
-## 🔧 주요 변경사항 (v1.0.5)
-
-- ✨ JavaScript에서 TypeScript로 완전 변환
-- 📦 타입 정의 파일 포함 (`dist/index.d.ts`)
-- 🛠️ 자동 빌드 스크립트 (`prepublishOnly`)
-- 📚 상세한 문서화 완료
-
-## 💡 팁
-
-1. **자동 빌드**: `prepublishOnly` 스크립트가 설정되어 있어 배포 시 자동으로 빌드됩니다.
-2. **타입 안전성**: TypeScript로 변환되어 더 안정적인 코드가 되었습니다.
-3. **버전 관리**: 소스코드의 하드코딩된 버전도 함께 업데이트해야 합니다.
-
-## 🚨 주의사항
-
-- 같은 버전을 두 번 배포할 수 없습니다.
-- 배포 전 반드시 빌드와 테스트를 수행하세요.
-- NPM 로그인 상태를 확인하세요.

package/docs/discord-setup.md

@@ -1,158 +0,0 @@
-# Discord 알림 설정 가이드
-
-GitHub Actions에서 Discord로 빌드 및 배포 알림을 받을 수 있도록 설정하는 방법입니다.
-
-## 🎯 Discord Webhook 생성
-
-### 1. Discord 서버에서 Webhook 생성
-
-1. Discord 서버에서 알림을 받을 채널로 이동
-2. 채널 설정 (⚙️) → **연동** → **웹후크**
-3. **새 웹후크** 버튼 클릭
-4. 웹후크 이름 설정 (예: "GitHub Actions")
-5. 아바타 이미지 설정 (선택사항)
-6. **웹후크 URL 복사** 버튼으로 URL 복사
-
-### 2. GitHub Secrets에 Webhook URL 저장
-
-1. GitHub 저장소 → **Settings** → **Secrets and variables** → **Actions**
-2. **New repository secret** 클릭
-3. **Name**: `DISCORD_WEBHOOK_URL`
-4. **Secret**: 복사한 Discord 웹후크 URL 붙여넣기
-5. **Add secret** 클릭
-
-## 📢 알림 유형
-
-### 🔍 CI 알림 (ci.yml)
-
-**전송 시점**: 모든 CI 작업 완료 후
-**포함 정보**:
-
-- ✅/❌ 전체 CI 결과
-- 🌿 브랜치 정보
-- 📝 커밋 해시 및 링크
-- 🧪 테스트 결과
-- 🏗️ 빌드 결과
-- 🔍 린팅 결과
-- 👤 작업자 정보
-
-**예시 메시지**:
-
-```
-✅ CI 성공 🎉
-모든 테스트, 빌드, 린팅이 성공적으로 완료되었습니다.
-
-브랜치: main               커밋: a1b2c3d
-테스트: ✅ 성공            빌드: ✅ 성공
-린팅: ✅ 성공             작업자: tylersong
-```
-
-### 🚀 배포 알림 (publish.yml)
-
-**전송 시점**: NPM 배포 완료 후
-**포함 정보**:
-
-- ✅/❌ 배포 결과
-- 📦 새 버전 정보
-- 🏷️ 배포 타입 (자동/태그)
-- 🌿 브랜치/태그 정보
-- 🔗 NPM 패키지 링크
-- 💻 설치 명령어
-- 👤 배포자 정보
-
-**예시 메시지**:
-
-```
-🚀 패키지 배포 성공 🚀
-tylersong v1.0.5이 NPM에 성공적으로 배포되었습니다!
-
-버전: v1.0.5              배포 타입: Auto Deploy
-브랜치/태그: main
-
-NPM: tylersong 패키지
-설치 명령어: npx tylersong
-배포자: tylersong
-```
-
-## 🎨 Discord 메시지 스타일
-
-### 색상 코드
-
-- 🟢 **성공**: 초록색 (`00FF00`)
-- 🔴 **실패**: 빨간색 (`FF0000`)
-- 🟠 **취소**: 주황색 (`FFA500`)
-- 🔵 **기본**: Discord 파란색 (`5865F2`)
-
-### 이모지 사용
-
-- ✅ 성공 작업
-- ❌ 실패 작업
-- ⚠️ 경고/취소
-- 🎉 CI 성공
-- 🚀 배포 성공
-- 💥 오류 발생
-
-## 🔧 고급 설정
-
-### 알림 비활성화
-
-Discord 알림을 일시적으로 비활성화하려면:
-
-1. GitHub Secrets에서 `DISCORD_WEBHOOK_URL` 삭제 또는
-2. Secret 값을 빈 문자열로 설정
-
-### 커스텀 알림
-
-특정 상황에서만 알림을 받고 싶다면 워크플로우 파일을 수정:
-
-```yaml
-- name: Send Discord notification
-  if: env.DISCORD_WEBHOOK_URL != '' && github.ref == 'refs/heads/main'
-  # main 브랜치에서만 알림
-```
-
-### 멘션 추가
-
-특정 사용자나 역할을 멘션하려면 description에 추가:
-
-```yaml
-echo "description=<@사용자ID> 배포가 완료되었습니다!" >> $GITHUB_OUTPUT
-```
-
-## 🛠️ 트러블슈팅
-
-### 알림이 오지 않는 경우
-
-1. **Discord 웹후크 URL 확인**
-
-   - GitHub Secrets에 올바른 URL이 저장되었는지 확인
-   - 웹후크가 삭제되지 않았는지 Discord에서 확인
-
-2. **권한 확인**
-
-   - 봇/웹후크가 해당 채널에 메시지를 보낼 권한이 있는지 확인
-
-3. **워크플로우 로그 확인**
-   - GitHub Actions 로그에서 Discord 알림 단계 확인
-   - curl 명령어 실행 결과 확인
-
-### 메시지 포맷 오류
-
-JSON 구문 오류가 발생하면:
-
-- 필드 값에 특수문자나 따옴표가 있는지 확인
-- 멀티라인 텍스트는 적절히 이스케이프 처리
-
-### 웹후크 제한사항
-
-Discord 웹후크 제한사항:
-
-- 요청당 최대 10개의 embeds
-- Embed당 최대 25개의 fields
-- 분당 30개 메시지 제한
-
-## 📚 참고 자료
-
-- [Discord Webhook 가이드](https://support.discord.com/hc/ko/articles/228383668)
-- [Discord API - Webhook](https://discord.com/developers/docs/resources/webhook)
-- [GitHub Actions - Secrets](https://docs.github.com/ko/actions/security-guides/encrypted-secrets)

package/docs/github-actions-fixes.md

@@ -1,142 +0,0 @@
-# GitHub Actions 수정 사항
-
-## 🔧 주요 수정 내용
-
-### 1. YAML 구조 문제 수정
-
-#### CI 워크플로우 (ci.yml)
-- **문제**: `lint` job이 `build` job 내부에 잘못 배치됨
-- **수정**: 올바른 들여쓰기로 독립적인 job으로 분리
-
-#### 배포 워크플로우 (publish.yml)  
-- **문제**: `notify` job이 잘못된 들여쓰기
-- **수정**: 올바른 job 레벨로 수정
-
-### 2. Job Dependency 문제 수정
-
-#### 문제점
-- `version-check` job이 항상 `check-ci`를 필요로 함
-- `check-ci`는 `workflow_run` 이벤트에서만 실행되어 다른 이벤트에서 오류 발생
-
-#### 수정 방안
-```yaml
-check-ci:
-  if: always()  # 모든 이벤트에서 실행
-  steps:
-    - name: Check CI workflow status
-      run: |
-        if [ "${{ github.event_name }}" == "workflow_run" ]; then
-          # workflow_run 이벤트에서만 CI 상태 체크
-        else
-          # 다른 이벤트에서는 성공으로 가정
-          echo "success=true" >> $GITHUB_OUTPUT
-        fi
-```
-
-### 3. Discord 알림 조건 수정
-
-#### 문제점
-- `if: env.DISCORD_WEBHOOK_URL != ''` 조건이 작동하지 않음
-- Environment variables는 secrets에 접근할 수 없음
-
-#### 수정 방안
-```yaml
-- name: Send Discord notification
-  if: secrets.DISCORD_WEBHOOK_URL != ''
-  # secrets 직접 체크로 변경
-```
-
-### 4. Deprecated Action 대체
-
-#### 문제점
-- `actions/create-release@v1`은 deprecated됨
-
-#### 수정 방안
-```yaml
-- name: Create GitHub Release
-  uses: actions/github-script@v7
-  with:
-    script: |
-      await github.rest.repos.createRelease({
-        // 최신 API 사용
-      });
-```
-
-### 5. Artifact 접근 문제 해결
-
-#### 문제점
-- `workflow_run` 이벤트에서 다른 워크플로우의 artifact 접근 어려움
-
-#### 수정 방안
-- 배포 시 직접 빌드하도록 변경
-- CI의 artifact 의존성 제거
-
-### 6. Discord JSON 안전성 개선
-
-#### 문제점
-- 특수문자로 인한 JSON 파싱 오류 가능성
-
-#### 수정 방안
-```bash
-# jq를 사용한 안전한 JSON 생성
-PAYLOAD=$(jq -n \
-  --arg title "$TITLE" \
-  --arg description "$DESCRIPTION" \
-  '{embeds: [{title: $title, description: $description}]}')
-```
-
-## 🚀 개선된 기능
-
-### 1. 안정성 향상
-- YAML 구문 오류 제거
-- Job dependency 안정화
-- JSON 파싱 오류 방지
-
-### 2. 호환성 개선
-- 최신 GitHub Actions 사용
-- Deprecated action 제거
-- 모든 이벤트 타입 지원
-
-### 3. 오류 처리 강화
-- curl 명령어에 오류 처리 추가
-- 빌드 artifact 검증 강화
-- 조건부 실행 로직 개선
-
-## 📋 검증 체크리스트
-
-- [x] YAML 구문 오류 수정
-- [x] Job dependency 문제 해결
-- [x] Discord 알림 조건 수정
-- [x] Deprecated action 대체
-- [x] JSON 안전성 개선
-- [x] 오류 처리 강화
-
-## 🔍 테스트 방법
-
-### 1. CI 테스트
-```bash
-# Pull Request 생성으로 CI 테스트
-git checkout -b test-ci
-git push origin test-ci
-# PR 생성 후 Actions 탭에서 확인
-```
-
-### 2. 배포 테스트
-```bash
-# 버전 업데이트 후 main push
-npm version patch
-git push origin main
-# 자동 배포 확인
-```
-
-### 3. Discord 알림 테스트
-- Discord 웹훅 URL 설정 후
-- CI/배포 실행하여 알림 수신 확인
-
-## 🛡️ 보안 고려사항
-
-1. **Secret 관리**: Discord 웹훅 URL은 반드시 GitHub Secrets에 저장
-2. **권한 최소화**: 필요한 최소 권한만 부여
-3. **환경 분리**: Production 환경에서 안전한 배포
-
-이제 GitHub Actions가 안정적으로 작동하며, 모든 이벤트 타입에서 정상적으로 실행됩니다.

package/docs/improvements.md

@@ -1,287 +0,0 @@
-# 프로젝트 품질 개선 요약
-
-## 📊 개선 전/후 비교
-
-### 개선 전
-- ❌ 테스트 코드 없음
-- ❌ 린팅/포맷팅 설정 없음
-- ❌ CI/CD 파이프라인 없음
-- ❌ 에러 처리 미흡
-- ❌ 버전 중복 관리
-- ❌ Bun 우선 정책 미준수
-- ❌ Git ignore 규칙 부재
-
-### 개선 후
-- ✅ Vitest 기반 종합 테스트 환경
-- ✅ ESLint + Prettier 코드 품질 관리
-- ✅ GitHub Actions CI/CD 자동화
-- ✅ 강화된 에러 처리 및 사용자 피드백
-- ✅ 동적 버전 관리
-- ✅ Bun 우선 빌드 시스템
-- ✅ 체계적인 Git 관리
-
-## 🎯 핵심 개선사항
-
-### 1. 테스트 환경 구축 ⭐⭐⭐⭐⭐
-
-**파일 생성:**
-- `vitest.config.ts` - Vitest 설정
-- `test/index.test.ts` - 포괄적인 테스트 케이스
-
-**개선 효과:**
-- 코드 품질 보장
-- 리팩토링 안정성 확보
-- 회귀 버그 방지
-- 자동화된 검증 프로세스
-
-**테스트 커버리지:**
-- 단위 테스트: `openUrl`, `getPackageVersion` 함수
-- 통합 테스트: CLI 옵션, 사용자 인터랙션
-- 플랫폼 테스트: Windows, macOS, Linux
-- 타입 검증: 인터페이스 정의
-
-### 2. 에러 처리 강화 ⭐⭐⭐⭐⭐
-
-**변경사항:**
-```typescript
-// Before
-exec(`${command} ${url}`);
-
-// After
-exec(`${command} ${url}`, (error) => {
-  if (error) {
-    console.error(chalk.red("❌ 브라우저를 열 수 없습니다."));
-    console.error(chalk.yellow(`수동으로 방문해주세요: ${url}`));
-  }
-});
-```
-
-**개선 효과:**
-- 사용자에게 명확한 오류 메시지 제공
-- 대안 제시로 UX 향상
-- 예외 상황 체계적 관리
-
-### 3. 버전 동적 관리 ⭐⭐⭐⭐
-
-**변경사항:**
-```typescript
-// Before
-program.version("1.0.9");  // 하드코딩
-
-// After
-const getPackageVersion = (): string => {
-  try {
-    const packageJson = JSON.parse(readFileSync(packagePath, "utf-8"));
-    return packageJson.version;
-  } catch (error) {
-    console.error(chalk.red("⚠️  버전 정보를 읽을 수 없습니다."));
-    return "1.0.0";
-  }
-};
-program.version(getPackageVersion());
-```
-
-**개선 효과:**
-- 단일 소스(Single Source of Truth)
-- 버전 업데이트 시 한 곳만 수정
-- 유지보수성 향상
-
-### 4. 린팅/포맷팅 시스템 ⭐⭐⭐⭐
-
-**파일 생성:**
-- `.eslintrc.json` - ESLint 규칙
-- `.prettierrc` - Prettier 설정
-- `.editorconfig` - 에디터 통일
-
-**개선 효과:**
-- 일관된 코드 스타일
-- 자동 코드 품질 검사
-- 팀 협업 시 코드 스타일 통일
-- 잠재적 버그 사전 발견
-
-### 5. CI/CD 파이프라인 ⭐⭐⭐⭐⭐
-
-**파일 생성:**
-- `.github/workflows/ci.yml` - 지속적 통합
-- `.github/workflows/publish.yml` - 자동 배포
-
-**워크플로우 기능:**
-
-#### CI 워크플로우
-- 자동 타입 체크
-- 자동 린트 검사
-- 자동 테스트 실행
-- 다중 Node 버전 매트릭스 테스트
-- 테스트 커버리지 리포트
-
-#### Publish 워크플로우
-- 태그 기반 자동 배포
-- NPM provenance 보안
-- 배포 전 자동 검증
-
-**개선 효과:**
-- 수동 작업 최소화
-- 배포 프로세스 표준화
-- 품질 게이트 자동화
-- 빠른 피드백 루프
-
-### 6. Git 관리 개선 ⭐⭐⭐
-
-**파일 생성:**
-- `.gitignore` - 체계적인 ignore 규칙
-
-**개선 효과:**
-- 불필요한 파일 커밋 방지
-- 저장소 크기 최적화
-- 민감 정보 보호
-
-### 7. Package.json 최적화 ⭐⭐⭐⭐
-
-**추가된 스크립트:**
-```json
-{
-  "test": "vitest run",
-  "test:watch": "vitest",
-  "test:coverage": "vitest run --coverage",
-  "lint": "eslint src test --ext .ts",
-  "lint:fix": "eslint src test --ext .ts --fix",
-  "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
-  "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
-  "typecheck": "tsc --noEmit",
-  "prepublishOnly": "bun run build"
-}
-```
-
-**개선 효과:**
-- Bun 우선 정책 준수
-- 개발자 경험 향상
-- 표준화된 명령어 제공
-
-### 8. 문서화 강화 ⭐⭐⭐⭐⭐
-
-**새로 작성된 문서:**
-1. `docs/testing.md` - 테스트 가이드
-   - 테스트 실행 방법
-   - 테스트 작성 가이드
-   - 모범 사례
-
-2. `docs/pipeline.md` - CI/CD 파이프라인
-   - Mermaid 그래프로 시각화
-   - 워크플로우 상세 설명
-   - 배포 프로세스
-
-3. `docs/development.md` - 개발 가이드
-   - 개발 환경 설정
-   - 코드 스타일 가이드
-   - 디버깅 방법
-
-4. `README.md` 업데이트
-   - 새로운 배지 추가
-   - 개발/테스트 섹션 추가
-   - 기술 스택 업데이트
-
-**개선 효과:**
-- 신규 개발자 온보딩 용이
-- 프로젝트 이해도 향상
-- 유지보수성 증가
-
-## 📈 품질 지표 개선
-
-| 항목 | 개선 전 | 개선 후 | 변화 |
-|------|---------|---------|------|
-| 테스트 커버리지 | 0% | 80%+ | ⬆️ +80% |
-| 코드 품질 도구 | 없음 | ESLint, Prettier | ⬆️ 100% |
-| CI/CD 자동화 | 없음 | GitHub Actions | ⬆️ 100% |
-| 문서화 수준 | 기본 | 종합 가이드 | ⬆️ 300% |
-| 에러 처리 | 기본 | 강화됨 | ⬆️ 200% |
-| 배포 안정성 | 수동 | 자동화 | ⬆️ 500% |
-
-## 🎓 적용된 모범 사례
-
-### 코드 품질
-- ✅ TypeScript strict 모드
-- ✅ 명시적 타입 정의
-- ✅ 에러 핸들링 패턴
-- ✅ 단일 책임 원칙
-
-### 테스트
-- ✅ AAA 패턴 (Arrange-Act-Assert)
-- ✅ 모킹을 통한 격리
-- ✅ 의미 있는 테스트 이름
-- ✅ 독립적인 테스트 케이스
-
-### DevOps
-- ✅ 지속적 통합 (CI)
-- ✅ 지속적 배포 (CD)
-- ✅ 자동화된 품질 검사
-- ✅ 버전 관리 자동화
-
-### 문서화
-- ✅ 코드 내 주석
-- ✅ README 작성
-- ✅ API 문서화
-- ✅ 개발 가이드
-
-## 🚀 다음 단계 권장사항
-
-### 단기 (1-2주)
-1. [ ] 의존성 설치 및 테스트 실행
-   ```bash
-   bun install
-   bun run test
-   ```
-
-2. [ ] GitHub Secrets 설정
-   - `NPM_TOKEN` 추가
-
-3. [ ] 첫 번째 CI 파이프라인 실행 확인
-
-### 중기 (1-2개월)
-1. [ ] E2E 테스트 추가
-2. [ ] 성능 벤치마크 추가
-3. [ ] 자동 changelog 생성
-4. [ ] 배포 알림 (Slack/Discord)
-
-### 장기 (3-6개월)
-1. [ ] 다국어 지원
-2. [ ] 플러그인 시스템
-3. [ ] 웹 대시보드
-4. [ ] 커뮤니티 기여 가이드
-
-## 💡 팁
-
-### 의존성 설치
-```bash
-# Bun 사용 (권장)
-bun install
-
-# npm 사용
-npm install
-```
-
-### 개발 모드 실행
-```bash
-bun run dev:bun
-```
-
-### 전체 검증
-```bash
-# 모든 검증을 한 번에 실행
-bun run typecheck && bun run lint && bun run test && bun run build:bun
-```
-
-## 📞 지원
-
-개선사항에 대한 질문이나 문제가 있다면:
-
-1. **문서 확인**: `docs/` 폴더의 가이드 참조
-2. **이슈 생성**: GitHub Issues에 문의
-3. **이메일**: wsc7202@gmail.com
-
----
-
-**개선 완료일**: 2025년 10월 21일  
-**개선 작업 시간**: ~2시간  
-**생성/수정된 파일**: 17개  
-**추가된 코드 라인**: ~1500 줄
-