시스템 메시지: [SEMO] Skill: deploy-npm 호출

deploy-npm Skill

SEMO npm 패키지 (@team-semicolon/semo-cli, @team-semicolon/semo-mcp) 배포 자동화

Purpose

Meta 환경에서 CLI 또는 MCP 서버 변경 후 npm 레지스트리에 배포합니다. Git commit/push, Slack 알림까지 포함된 End-to-End 배포 워크플로우입니다.

배포 대상 패키지

패키지	npm 이름	경로
CLI	@team-semicolon/semo-cli	packages/cli
MCP	@team-semicolon/semo-mcp	packages/mcp-server

Full Workflow (End-to-End)

[SEMO] deploy-npm 스킬 실행
├─ 1. Pre-check: 변경사항 확인 (git status)
├─ 2. Version bump: 버전 업데이트
├─ 3. Build: npm run build
├─ 4. Commit: git commit
├─ 5. Push: git push origin main
├─ 6. Publish: npm publish
├─ 7. Tag: git tag & push
└─ 8. Notify: Slack 알림

Step 1: Pre-check (변경사항 확인)

# 작업 디렉토리 상태 확인
git status

# CLI 변경 확인
git diff --name-only HEAD~1 | grep -q "packages/cli" && echo "CLI 변경됨"

# MCP 변경 확인
git diff --name-only HEAD~1 | grep -q "packages/mcp-server" && echo "MCP 변경됨"

Step 2: 버전 범프

# packages/cli/
cd packages/cli
npm version patch  # or minor/major

# packages/mcp-server/
cd packages/mcp-server
npm version patch  # or minor/major

Step 3: 빌드

# CLI 빌드
cd packages/cli && npm run build

# MCP 빌드
cd packages/mcp-server && npm run build

Step 4: Git Commit

# 변경사항 스테이징
git add packages/cli/package.json packages/cli/dist/

# 커밋 (버전 포함)
git commit -m "chore(cli): bump version to $(cat packages/cli/package.json | jq -r .version)

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>"

Step 5: Git Push

git push origin main

Step 6: npm 배포

# CLI 배포
cd packages/cli && npm publish --access public

# MCP 배포
cd packages/mcp-server && npm publish --access public

Step 7: Git 태그

# 태그 생성
git tag -a "cli-v$(cat packages/cli/package.json | jq -r .version)" -m "CLI release"
git tag -a "mcp-v$(cat packages/mcp-server/package.json | jq -r .version)" -m "MCP release"
git push origin --tags

Step 8: Slack 알림 (MCP Tool 사용)

배포 완료 후 mcp__semo-integrations__slack_send_message 도구를 사용하여 알림을 보냅니다.

알림 메시지 형식:

🚀 SEMO 패키지 배포 완료

📦 @team-semicolon/semo-cli v{version}
- 변경사항: {변경 요약}
- npm: https://www.npmjs.com/package/@team-semicolon/semo-cli

✅ 배포 시간: {timestamp}

도구 호출 예시:

mcp__semo-integrations__slack_send_message
- text: "🚀 SEMO CLI v3.0.3 배포 완료\n\n변경사항:\n- update 명령어 개선\n\nnpm: https://www.npmjs.com/package/@team-semicolon/semo-cli"

Version Bump Rules

변경 유형	버전 범프	예시
버그 수정, 문서 수정	patch	1.0.0 → 1.0.1
새 기능 추가	minor	1.0.0 → 1.1.0
Breaking Change	major	1.0.0 → 2.0.0

Output Format

[SEMO] Skill: deploy-npm 호출

## npm 배포 결과

| 패키지 | 이전 버전 | 새 버전 | 상태 |
|--------|----------|--------|------|
| @team-semicolon/semo-cli | 3.0.0 | 3.0.1 | ✅ 배포 완료 |
| @team-semicolon/semo-mcp | 1.2.0 | - | ⏭️ 변경 없음 |

### 배포 로그

\`\`\`
npm notice package size: 12.5 kB
npm notice total files: 8
+ @team-semicolon/semo-cli@3.0.1
\`\`\`

[SEMO] Skill: deploy-npm 완료

Error Handling

npm 인증 오류

❌ npm 인증 실패

**해결 방법**:
\`\`\`bash
npm login --registry=https://registry.npmjs.org/
\`\`\`

버전 충돌

❌ 버전 충돌: 3.0.1 이미 존재

**해결 방법**:
\`\`\`bash
npm version patch  # 다음 버전으로 범프
\`\`\`

Pre-requisites

• npm 로그인 상태 (npm whoami)
• @team-semicolon 조직 publish 권한

Related

• version-manager - 버저닝 자동화
• package-sync - 로컬 동기화