tylersong 1.0.7 → 1.0.9

package/docs/auto-deployment.md

@@ -1,191 +0,0 @@
-# 자동 배포 시스템 가이드
-
-## 🎯 개요
-이 시스템은 main 브랜치에 PR이 merge될 때 자동으로 버전을 업데이트하고 NPM에 배포하는 완전 자동화된 배포 시스템입니다.
-
-## 🚀 작동 방식
-
-### 1. 자동 트리거
-- **main 브랜치로의 PR merge**: CI 완료 후 자동 배포 시작
-- **main 브랜치로의 직접 push**: 즉시 자동 배포 시작
-- **태그 push**: 기존 태그 기반 배포 유지
-
-### 2. 자동 버전 결정 (Semantic Versioning)
-커밋 메시지를 분석하여 자동으로 버전 타입을 결정합니다:
-
-#### 🔴 Major 버전 (X.0.0)
-```bash
-# Breaking changes
-git commit -m "feat!: completely new API structure"
-git commit -m "fix!: remove deprecated method"
-git commit -m "feat: add new feature
-
-BREAKING CHANGE: This removes the old API"
-```
-
-#### 🟡 Minor 버전 (0.X.0)  
-```bash
-# New features
-git commit -m "feat: add user profile management"
-git commit -m "feat(auth): implement OAuth login"
-```
-
-#### 🟢 Patch 버전 (0.0.X)
-```bash
-# Bug fixes, docs, chores (default)
-git commit -m "fix: resolve login redirect issue"
-git commit -m "docs: update README"
-git commit -m "chore: update dependencies"
-git commit -m "style: fix code formatting"
-```
-
-### 3. 자동 실행 과정
-1. **CI 실행**: 테스트, 빌드, 린팅
-2. **버전 분석**: 현재 버전 vs NPM 배포 버전 비교
-3. **자동 버전 업데이트**: 필요 시 package.json 및 소스코드 버전 업데이트
-4. **자동 커밋**: 버전 업데이트 커밋 생성 및 푸시
-5. **빌드 및 배포**: TypeScript 빌드 후 NPM 배포
-6. **알림**: Discord 및 콘솔 알림
-
-## 📋 사전 설정 요구사항
-
-### 1. GitHub Secrets 설정
-```bash
-# NPM 토큰 설정 (필수)
-NPM_TOKEN=your_npm_token_here
-
-# Discord 알림 (선택사항)
-DISCORD_WEBHOOK_URL=your_discord_webhook_url
-```
-
-### 2. NPM 토큰 생성 방법
-1. [npmjs.com](https://www.npmjs.com)에 로그인
-2. Profile → Access Tokens → Generate New Token
-3. **Automation** 타입 선택
-4. 생성된 토큰을 GitHub Repository Settings → Secrets에 `NPM_TOKEN`으로 추가
-
-## 🎨 Conventional Commits 가이드
-
-### 기본 형식
-```
-<type>[optional scope]: <description>
-
-[optional body]
-
-[optional footer(s)]
-```
-
-### 주요 타입들
-| 타입 | 설명 | 버전 영향 |
-|------|------|-----------|
-| `feat` | 새로운 기능 | Minor |
-| `fix` | 버그 수정 | Patch |
-| `docs` | 문서 변경 | Patch |
-| `style` | 코드 스타일 변경 | Patch |
-| `refactor` | 코드 리팩토링 | Patch |
-| `test` | 테스트 추가/수정 | Patch |
-| `chore` | 빌드/설정 변경 | Patch |
-| `!` | Breaking Change | Major |
-
-### 실제 예시
-```bash
-# 새 기능 추가 (Minor 버전 증가)
-git commit -m "feat: add interactive CLI menu"
-
-# 버그 수정 (Patch 버전 증가)  
-git commit -m "fix: resolve command parsing error"
-
-# Breaking Change (Major 버전 증가)
-git commit -m "feat!: redesign CLI interface"
-
-# 상세한 설명이 있는 커밋
-git commit -m "feat: add color themes
-
-- Add dark and light theme options
-- Implement theme persistence
-- Update help text with theme info"
-```
-
-## 🔧 워크플로우 파일 구성
-
-### 주요 작업들
-1. **check-ci**: CI 상태 확인
-2. **auto-version**: 자동 버전 업데이트 및 결정
-3. **version-check**: 태그 기반 배포용 버전 확인
-4. **publish**: NPM 배포 실행
-5. **notify**: 결과 알림
-
-### 트리거 조건
-```yaml
-on:
-  push:
-    branches: [main]        # main 브랜치 직접 push
-    tags: ["v*"]           # 태그 push
-  workflow_run:
-    workflows: ["Continuous Integration"]
-    types: [completed]      # CI 완료 후
-    branches: [main]
-```
-
-## 📊 배포 시나리오
-
-### 시나리오 1: 첫 PR merge
-```
-현재 NPM: v1.0.5
-현재 코드: v1.0.5
-→ 자동으로 v1.0.6으로 업데이트 후 배포
-```
-
-### 시나리오 2: 이미 다른 버전인 경우
-```
-현재 NPM: v1.0.5  
-현재 코드: v1.0.6
-→ 버전 업데이트 없이 v1.0.6 즉시 배포
-```
-
-### 시나리오 3: 태그 기반 배포
-```
-태그 push: v1.1.0
-→ 버전 체크만 하고 즉시 배포
-```
-
-## 🚨 주의사항
-
-### 1. 권한 설정
-- GitHub Actions에 repository write 권한 필요
-- NPM 토큰이 올바르게 설정되어야 함
-
-### 2. 커밋 메시지 규칙
-- Conventional Commits 형식 권장
-- 명확하고 일관된 메시지 작성
-
-### 3. CI/CD 최적화  
-- `[skip ci]` 태그로 무한 루프 방지
-- 버전 업데이트 커밋은 자동으로 CI 건너뛰기
-
-## 🎉 장점
-
-### ✅ 완전 자동화
-- 수동 버전 관리 불필요
-- 실수 방지 및 일관성 보장
-
-### ✅ Semantic Versioning 준수
-- 커밋 메시지 기반 자동 버전 결정
-- 표준화된 버전 관리
-
-### ✅ 실시간 알림
-- Discord 및 콘솔 배포 상태 알림
-- 성공/실패 즉시 확인
-
-## 🔍 디버깅
-
-### 로그 확인 위치
-- GitHub Actions → 해당 워크플로우 실행 → 각 작업 로그
-
-### 일반적인 문제들
-1. **NPM 토큰 오류**: Secrets 설정 확인
-2. **버전 충돌**: NPM에서 같은 버전 이미 배포됨
-3. **빌드 실패**: TypeScript 컴파일 오류 확인
-4. **권한 오류**: GitHub token 권한 확인
-
-이제 PR만 merge하면 자동으로 버전이 업데이트되고 NPM에 배포됩니다! 🚀

package/docs/deployment.md

@@ -1,82 +0,0 @@
-# 배포 가이드
-
-## CI/CD 파이프라인
-
-이 프로젝트는 모듈화된 GitHub Actions를 사용한 자동 배포 시스템을 구축했습니다.
-
-> 📖 **워크플로우 구조**: 자세한 내용은 [docs/workflows.md](./workflows.md)를 참고해주세요.
-
-### 트리거 조건
-
-#### 1. Pull Request
-
-- `main` 브랜치로의 PR 시 테스트와 빌드만 실행
-- Node.js와 Bun 두 환경에서 모두 테스트
-
-#### 2. Main 브랜치 Push
-
-- `main` 브랜치에 직접 push 시
-- 버전이 변경된 경우에만 NPM에 자동 배포
-- package.json의 버전과 NPM에 이미 배포된 버전을 비교
-
-#### 3. 태그 Push
-
-- `v*` 형태의 태그 push 시 무조건 NPM에 배포
-- 예: `v1.0.5`, `v2.1.0`
-
-### 배포 워크플로우
-
-```mermaid
-graph LR
-    A[Code Push] --> B{브랜치 확인}
-    B -->|main| C[버전 체크]
-    B -->|태그| F[즉시 배포]
-    C -->|변경됨| D[테스트 & 빌드]
-    C -->|동일함| E[배포 스킵]
-    D --> F[NPM 배포]
-```
-
-### 수동 배포 방법
-
-#### 1. 버전 업데이트 후 main 브랜치 배포
-
-```bash
-# 버전 업데이트
-npm version patch  # 또는 minor, major
-
-# main 브랜치에 push (자동 배포됨)
-git push origin main
-```
-
-#### 2. 태그를 통한 배포
-
-```bash
-# 버전 업데이트
-npm version patch
-
-# 태그와 함께 push (즉시 배포됨)
-git push origin main --tags
-```
-
-### 환경 변수 설정
-
-GitHub Repository Settings에서 다음 Secret을 설정해야 합니다:
-
-- `NPM_TOKEN`: NPM 계정의 액세스 토큰
-
-### 지원 런타임
-
-- **Node.js 20.x**: 메인 런타임
-- **Bun Latest**: 성능 테스트 및 대안 빌드
-
-### 빌드 산출물
-
-- TypeScript 컴파일된 JavaScript 파일들
-- 타입 정의 파일 (.d.ts)
-- 소스맵 파일
-
-### 주의사항
-
-1. **버전 관리**: package.json의 버전을 먼저 업데이트해야 배포됩니다
-2. **테스트 통과**: 모든 테스트가 통과해야 배포가 진행됩니다
-3. **권한**: NPM_TOKEN이 올바르게 설정되어야 합니다

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가 안정적으로 작동하며, 모든 이벤트 타입에서 정상적으로 실행됩니다.