ci: say compatibility.json is a record and check its consistency

[Eomdahyeon]

Closes #788

결정 — 이슈의 두 선택지 중 두 번째

compatibility.json 은 "Builder and Studio CI read this file" 라고 적고 있지만 세 저장소 어디에도 읽는 CI 가 없다. 이슈는 (1) 실제로 읽는 게이트를 만들거나 (2) 문장을 지우고 문서로만 취급한다고 명시하라고 했다.

(2)를 택했다. (1)은 Builder·Studio 의 워크플로가 다른 저장소의 파일을 가져와야 하는데, 그 워크플로 변경은 이 계정으로 push 할 수 없고, Builder 의 실제 핀은 이미 uv lock --check 와 kpubdata main ↔ Builder 잡이 검증한다 — 같은 사실을 세 번째 장소에서 다시 게이트로 만들 근거가 약하다고 판단했다. 나중에 (1)이 필요해지면 아래 테스트가 그 출발점이 된다.

변경 내용

• compatibility.json 의 description: CI 가 읽는다는 문장을 지우고, 사람과 릴리스 노트를 위한 기록이라고 적었다.
• tests/unit/test_compatibility_json.py: 다른 저장소 없이 확인할 수 있는 것을 확인한다 — 파일 형식, supported 범위가 정확히 하나이고 이 패키지의 버전이 그 안에 있음, 그 범위가 docs/compatibility.md 가 적은 핀과 같음.
• CHANGELOG [Unreleased] Changed.

하지 않은 것

• 이슈가 짚은 "0.7 행이 없다" 는 고치지 않았다. 0.7 대 릴리스의 Builder/Studio 버전을 근거 없이 채우고 싶지 않았다.

검증

새 테스트와 test_release_freeze.py 통과. ruff 통과. 전체 스위트는 CI 가 돌린다.

review:R3 이슈다 — 작성자가 아닌 사람의 승인이 필요하다.

🤖 Generated with Claude Code

[yeongseon]

리뷰 (코멘트, 승인 아님 — R3).

결정에 동의합니다: compatibility.json 은 기록용으로 둡니다. Builder 의 핀은 uv lock --check 와 kpubdata main ↔ Builder 잡이 이미 검증하므로 세 번째 게이트를 만들 근거가 약합니다.

• main 과 충돌 상태(CHANGELOG)라 리베이스가 필요합니다.
• 사소: test_it_no_longer_claims_a_ci_reads_it 는 description 문구를 문자열로 단언해서 문장을 다듬기만 해도 깨집니다. 막을 정도는 아닙니다.

로컬에서 테스트를 돌리지는 않았습니다.

[Eomdahyeon]

리뷰 반영: main 위로 리베이스했고, 지적한 테스트는 틀린 주장("CI read this file")이 없다는 것만 단언하도록 줄였다 — 설명 문장을 다듬어도 깨지지 않는다.

[yeongseon]

리베이스 확인했습니다. 앞선 리뷰에서 짚은 문구 단언("no CI" in description)도 빠졌고, 그 밖의 내용은 그대로이며 CLEAN 입니다. 승인합니다.