v0.25.2
0.22.0 설치본을 0.25.1 로 올리는 전 과정을 재현해, 문서를 그대로 따라가도 끝나지 않은 채로 끝난 줄 아는 지점들을 고쳤습니다.
docs — 업그레이드 절차를 한 구역으로
- 🔴 반복까지가 절차입니다. 폐기된 계약 서술(
contract-claims)은 한 문서의 여러 자리에 있을 수 있습니다. 실측에서AGENTS.md한 파일에 두 자리가 있었고, 첫 자리를 고친 뒤check를 다시 돌려서야 두 번째가 나왔습니다. - 🔴 인용된 문장을 그대로 검색하면 찾지 못할 수 있습니다 — 대조 전에 강조·코드 표시 문자를 제거하기 때문입니다.
- 🔴 끝났는지 판정하는 기준을 적었습니다:
C7의 조치 0. - 🔴 어느 진단에도 걸리지 않는 축(companion skills·
.cursor규칙)의 대조 경로와,diff가 정상인데도 내는 비대칭 둘.
README 의 업그레이드 진입점은 이제 고치는 명령이 아니라 진단(npx commitgate check)입니다. 무엇을 실행할지는 축마다 다르고, 그것을 아는 것은 도구입니다.
fix — 마지막 phase 리뷰가 막히던 스키마 안내 공백
이 릴리스를 만들다 실제로 걸렸습니다. REQ 의 마지막 phase 를 리뷰하면 리뷰어가 status="STEP_COMPLETE" 와 merge_ready="yes" 를 함께 내고, 도구가 그것을 모순으로 옳게 거부해 BLOCKED 됩니다.
원인은 판정이 아니라 안내였습니다 — 교차 규칙을 도구가 검사만 하고 리뷰어가 받는 스키마에는 적지 않았습니다. status·merge_ready 에 설명을 넣었고, 마지막 phase 여도 merge_ready="no" 라는 것을 명시합니다. 검증 규칙 자체는 그대로입니다.
스키마는 vendored 자산이라 소비 프로젝트는 npx commitgate sync --apply 로 받습니다.