#10. 프로젝트 전용 명령어

# Node.js 버전 설정 (.nvmrc 기준)
nvm use

# 의존성 설치
pnpm install

# 의존성 설치 (잠금 파일 기준)
pnpm install --frozen-lockfile   # CI 환경

# 빌드 (tsup — index / server / cli 3개 엔트리)
pnpm build

# 개발 모드 (파일 변경 감시)
pnpm dev

# 클린 (dist, coverage, doc_build, node_modules 제거)
pnpm clean

# 린트
pnpm lint

# 포맷
pnpm format
pnpm format:check

pnpm typecheck        # tsc --noEmit

# 문서 사이트 로컬 개발 서버 실행
pnpm docs:dev

# 문서 사이트 정적 빌드 (doc_build/ 디렉토리 출력)
pnpm docs:build

# 전체 테스트 (agent 테스트는 자동으로 건너뜀)
pnpm test

# 에이전트 테스트만 실행 (LLM + 네트워크 필요)
pnpm test:agent

# 1. 린트
pnpm lint

# 2. 포맷 검사
pnpm format:check

# 3. 타입 검사
pnpm typecheck

# 4. 테스트
pnpm test

# 5. 빌드
pnpm build

# npx로 직접 실행 (npm 배포 버전)
npx @julong/mcp-kit

# 로컬 빌드 실행 — 같은 동작을 스크립트로
pnpm build && pnpm start

# 로컬 빌드에서 도구 하나만 실행
pnpm start:cli nowPlayingMoviesTool

# MCP Inspector로 디버깅
pnpm inspect

# MCP Client Config
# {
#   "mcpServers": {
#     "@julong/mcp-kit": {
#       "command": "npx",
#       "args": ["-y", "@julong/mcp-kit"],
#       "env": { "TMDB_API_KEY": "<발급받은-키>" }
#     }
#   }
# }

printf '%s\n%s\n%s\n' \
  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"probe","version":"1"}}}' \
  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
  '{"jsonrpc":"2.0","id":2,"method":"tools/list"}' \
  | pnpm -s start

# 저장소 루트의 .env에서 읽어 심기
pnpm build

# 이번 빌드에만 심기
TMDB_API_KEY=<your-key> pnpm build

# 이제 환경 변수 없이도 영화 도구가 돕니다
node dist/cli.js nowPlayingMoviesTool

# 도구 목록 보기
npx mcp-kit-cli

# 환율 도구 실행 — 최초 1회 `npx playwright install chromium` 필요
npx mcp-kit-cli exchangeRatesTool
npx mcp-kit-cli exchangeRatesTool '["naver","daum"]' '["CNY","JPY"]'
npx mcp-kit-cli exchangeRateTool google EUR

# 로컬 빌드로 CLI 실행
node dist/cli.js exchangeRateTool naver CNY

# 한 번 빌드한 뒤 로컬 CLI로 실행
pnpm build

# 상영 중 / 개봉 예정 (기본값: language=ko-KR, region=KR)
TMDB_API_KEY=<발급받은-키> node dist/cli.js nowPlayingMoviesTool
TMDB_API_KEY=<발급받은-키> node dist/cli.js upcomingMoviesTool

# 한국 개봉 기준이 아닌 목록
TMDB_API_KEY=<발급받은-키> node dist/cli.js nowPlayingMoviesTool en-US US

# 기준 영화 기반 추천 (인자 순서: title, movieId, genre, ...)
TMDB_API_KEY=<발급받은-키> node dist/cli.js movieRecommendationsTool 인터스텔라
TMDB_API_KEY=<발급받은-키> node dist/cli.js movieRecommendationsTool null 157336

# 기준 영화 없이 추천 — 이미 개봉한 작품을 인기순으로
TMDB_API_KEY=<발급받은-키> node dist/cli.js movieRecommendationsTool null null 액션

# MCP 서버 자체를 stdio로 띄워 확인
TMDB_API_KEY=<발급받은-키> npx @modelcontextprotocol/inspector node dist/server.js

# 1. 환경 변수 템플릿을 복사해 LLM 자격 증명을 채웁니다
cp .env.example .env

# 2. 에이전트가 띄울 MCP 서버 번들을 먼저 빌드합니다
pnpm build

# 3. 에이전트를 검증으로 실행
pnpm test:agent

# 4. 전체 실행 로그 확인
less src/common/.log/rstest-agent-all.log

# feat: 새로운 기능 (minor 릴리스)
git commit -m "feat(scope): add new feature"

# fix: 버그 수정 (patch 릴리스)
git commit -m "fix(scope): resolve null reference"

# BREAKING CHANGE (major 릴리스)
git commit -m "feat(scope)!: rename public API
"
# 또는 footer에 BREAKING CHANGE 명시
git commit -m "feat(scope): rename public API

BREAKING CHANGE: oldName has been renamed to newName"

# 문서/설정 변경 (릴리스 없음)
git commit -m "docs: update README"
git commit -m "chore: update dependencies"
git commit -m "refactor(scope): restructure module"

# 1. 작업 브랜치를 push하고 main을 대상으로 PR을 엽니다
git push -u origin <branch>
gh pr create --base main

# 2. PR에서 CI가 돌고, 통과하면 병합합니다

# 3. 병합되면 release-please가 버전 Bump + CHANGELOG를 담은
#    릴리스 PR을 열거나 업데이트합니다

# 4. 그 릴리스 PR을 머지하면 실제 릴리스가 수행됩니다:
#    태그(v<version>) + GitHub Release가 생성되고,
#    이어서 publish 잡이 `pnpm publish`로 npm에 배포

# 빌드된 번들 내용 확인
ls dist/

# 스킬 문서 확인
ls skills/

# 문서 사이트 빌드 결과 확인
ls doc_build/

# pnpm 저장소 문제
pnpm store prune
rm -rf node_modules
pnpm install

# 전체 클린
pnpm clean && pnpm install && pnpm build

# Playwright 브라우저 미설치로 환율 조회가 실패할 때
npx playwright install chromium

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"1"}}}' \
  | npx -y @julong/mcp-kit