[Level 2] 역할별 화성/음역/겹침/신뢰도 산출 구현

[seonghobae]

배경

BandScope의 핵심 산출물은 role-aware harmony와 playable range, overlap warning, confidence다. 현재는 전역 chord 분석도 없고, role-aware output도 없다.

목표

section + role 기준으로 실제 rehearsal에 쓸 수 있는 harmony/range/overlap/confidence 결과를 생성한다.

구현 범위

• role-specific harmonic guidance output 정의
• playable range 추정과 density/overlap warning 추가
• low-confidence signal과 uncertainty explanation 정의
• 같은 시점에 서로 다른 role이 다른 harmonic function을 가질 수 있는 contract 구현
• engine fixture와 regression tests 추가

선행 이슈

• [Level 1] 공유 rehearsal domain contracts 정의 (song -> section -> role) #29
• [Level 2] 역할 분리(role extraction target)와 파트 그래프 구현 #34
• [Level 2] 섹션/폼/큐 앵커 추출 파이프라인 구현 #35

완료 기준

• song -> section -> role 기준의 harmony output이 생성된다.
• range/overlap warning이 role별로 제공된다.
• low-confidence 구간이 명시적으로 표시된다.
• keyboard hands와 lead/backing vocal을 별도 harmonic target으로 다룰 수 있다.
• 결과가 UI와 export에서 동일 schema로 소비된다.
• representative fixture에서 regression test가 통과한다.