changeset

Changeset

bun changeset이 감지한 변경 패키지를 후보로 삼아, 패키지별 bump를 사용자에게 확정받고, 확인 후 .changeset/*.md 파일을 작성한다.

SEED는 2.0부터 strict semver를 따른다 (breaking change는 major에서만). bump 결정은 references/version-matrix.md의 전파 매트릭스를 단일 기준으로 삼는다 — 한 패키지의 변경이 그것을 의존하는 패키지로 어떻게 전파되는지가 핵심이다.

실행 절차

Phase 1: 변경 패키지 감지 (후보 목록)

bun changeset CLI로 변경된(=릴리스 대상) 패키지 후보 목록을 얻는다. 이 CLI는 인터랙티브라 그냥 실행하면 입력을 기다리며 멈추므로, 백그라운드로 실행한 뒤 종료시키고 출력만 capture한다.

( bun changeset </dev/null >/tmp/changeset-detect.txt 2>&1 ) &
p=$!; sleep 4; kill "$p" 2>/dev/null; wait "$p" 2>/dev/null
# ANSI/커서 제어문자 제거 후 'changed packages' 섹션의 패키지명만 추출
perl -pe 's/\e\[[0-9;?]*[a-zA-Z]//g' /tmp/changeset-detect.txt \
  | sed -n '/changed packages/,/unchanged packages/p' \
  | grep -oE '@[a-z-]+/[a-z0-9-]+' | sort -u

1. 추출된 changed packages를 후보 목록으로 삼는다. 포함 여부와 bump는 Phase 2에서 패키지별로 확정한다.
   • bun changeset은 private 패키지를 이미 제외하므로 따로 거를 필요 없다.
   • packages/archive/*는 버전을 올리지 않는다. 파일을 고치는 것은 괜찮지만 changeset에는 넣지 않는다. private이 아닌 것들이 있어 CLI 후보에 올라오므로 여기서 걸러야 한다. @seed-design/react-theming이 archive에 있어 이름만 보면 현역처럼 보이는 것이 함정이다.
   • grep 결과가 비거나 잘려 보이면 /tmp/changeset-detect.txt를 직접 읽어 changed packages 블록을 눈으로 확인한다 (긴 목록은 터미널 폭에 맞춰 잘려 보일 수 있다).
2. 이미 존재하는 .changeset/*.md 파일을 읽어 이미 커버된 패키지가 있는지 확인한다.
   • 이미 커버된 패키지가 있다면 사용자에게 알리고, 추가 changeset이 필요한지 확인한다.

[!NOTE] CLI 목록은 .changeset/config.json의 baseBranch(보통 dev) 기준이라, 현재 브랜치가 dev에 머지되지 않은 커밋들 위에 stacked되어 있으면 하위 커밋의 패키지까지 끌려와 부풀 수 있다. 이건 Phase 2에서 사용자가 안함(제외)으로 걸러내면 되므로, 여기서는 후보를 넓게 잡아도 된다.

Phase 2: 패키지별 bump 확정 (AskUserQuestion)

후보의 각 패키지마다 실제 변경 내용을 확인하고(git diff <패키지_경로> 또는 커밋 로그), references/version-matrix.md의 전파 매트릭스로 추천 bump를 정한 뒤, AskUserQuestion으로 사용자에게 패키지별 bump를 확정받는다.

1. 전파 후보 확장: 한 패키지를 bump하면 그것을 의존하는 패키지도 매트릭스의 "2단계. 전파"대로 함께 후보에 올린다. css 소비자는 react 하나가 아니라 7개다 (react·stackflow·tailwind3-plugin·tailwind4-theme·vite-plugin·rsbuild-plugin·webpack-plugin) — 어느 게 해당하는지는 매트릭스의 "실제로 쓰는"의 판정 표로 가른다. headless가 오르면 react(dependency로 소비), react가 major면 figma(major 정렬). bun changeset이 stacked 등으로 못 잡은 dependent도 여기서 직접 추가한다.
2. 패키지 1개당 질문 1개. 옵션은 major / minor / patch / 안함(제외) 4개.
   • 모델이 분석한 추천 타입을 **첫 번째 옵션으로 두고 라벨에 (추천)**을 붙인다. 판단 근거(매트릭스의 어느 행인지)는 옵션 description에 적는다.
   • 안함(제외)은 그 패키지를 changeset에서 빼는 선택지다. stacked로 딸려온 무관 패키지나 changeset이 불필요한 패키지에 사용한다.
3. AskUserQuestion은 호출당 질문 4개까지 가능하므로, 후보가 5개 이상이면 4개씩 나눠 여러 번 호출한다.
4. 안함으로 답한 패키지는 제외하고, 나머지를 확정 목록으로 삼는다.
   • 주의 (2.0): 공개 표면을 깨는 변경(공개 prop/API·recipe·slot·variant·토큰·공개 data attr 이름변경·삭제, headless breaking을 extend 등)은 **major**다. 1.x처럼 minor로 답하지 않는다.
   • 주의 (시각 변경): **의도적인 색상 값 변경·재디자인도 major**다. 이름이 그대로여도 소비자 화면이 달라지고, minor는 ^ 범위에서 자동 설치되므로 보호가 되지 않는다. 반대로 틀렸던 값을 고치는 것(대비 미달, 스펙 불일치)은 patch다. 관절은 "원래 틀렸었나 / 맞았는데 바꾸는 건가" 하나다.
   • 내부 배선(styling 전용 data-*, typography를 제외한 vars/component/*) 이동·삭제는 비공개라 breaking이 아니다(patch/minor). 판단이 헷갈리면 references/version-matrix.md로 확인한다.