grafana-mcp: Skill for Claude Code

npm 배포를 수행한다. 아래 절차를 순서대로 실행하고, 단계를 임의로 생략하지 않는다. 로컬에서 npm publish 를 직접 실행하지 않는다 — 배포 주체는 GitHub Actions 다 (.claude/rules/npm-publish-rule.md).

0. 인자

• 버전 종류: patch(기본) / minor / major, 또는 명시 버전(예: 0.2.0)
• 사용자가 안 주면 변경 내용으로 판단한다: 버그픽스·문구·env 추가·의존성 갱신 → patch, 새 도구·인자·출력 형태 변경 → minor, 기존 소비자가 깨지는 변경 → major

1. 사전 점검 (하나라도 실패하면 멈추고 사용자에게 알린다)

node -v                       # package.json engines(>=22) 를 만족해야 함
git status --short            # 비어 있어야 함 (미커밋 변경 금지)
git branch --show-current     # main 이어야 함. 아니면 먼저 main 에 병합
git fetch origin && git log origin/main..main --oneline   # 미푸시 커밋은 있어도 됨 (같이 push 됨)
npm ci --dry-run 2>&1 | grep -i "error"   # 락파일 동기화 확인, 출력 없어야 함
npm run build && npm run lint
npm audit --omit=dev          # 런타임 의존성 취약점. 있으면 사용자에게 알리고 진행 여부 확인

• README 릴리즈 직전 재확인: CLAUDE.md 의 "README 동기화" 5단계를 수행한다.
  1. git describe --tags --abbrev=0 로 직전 릴리즈 태그를 찾는다.
  2. git diff <직전 태그>..HEAD 로 바뀐 것을 항목으로 뽑는다.
  3. README.md 와 README_kr.md 를 처음부터 끝까지 line by line 대조한다.
  4. 결과(수정한 줄, 또는 대조한 범위와 "반영할 것 없음")를 보고에 남긴다.
• package.json 의 repository.url 이 git+https://github.com/ninanung/grafana-mcp.git 인지 확인한다 (Trusted Publishing·provenance 매칭 조건).

2. 릴리스 노트 준비

git log <직전 태그>..HEAD --oneline 으로 변경을 모아 한 줄 요약을 만든다. 사용자에게 보여 주고 버전 종류가 맞는지 짧게 확인한다 (사용자가 이미 버전을 지정했으면 생략).

3. 버전 올리고 태그 push

npm version <patch|minor|major|x.y.z> -m "%s"   # package.json·lockfile 갱신 + 커밋("0.1.4") + v0.1.4 태그
git push --follow-tags origin main

• 커밋 메시지는 버전 숫자만 쓴다 (이력의 0.1.2, 0.1.3 과 같은 형식).
• npm version 이 만든 태그(v0.1.4 형식)가 워크플로 트리거다.
• 태그를 손으로 만들 때도 v 접두를 붙인다. git tag v<버전> 으로 만든 태그는 --follow-tags 로 올라가지 않으므로 git push origin v<버전> 으로 따로 push 한다.

4. 워크플로 완료 대기 및 검증

gh run list --workflow=publish.yml --limit 1 --json databaseId,headBranch,status   # run id 확보
gh run watch <run-id> --exit-status --interval 10
npm view @seungje.jun/grafana-mcp@<버전> version dist.attestations --prefer-online   # 새 버전 + provenance 확인