vibe-coding-universal은 범용 코드 스키마와 비교 문서를 생성하는 도구입니다. 핵심 기능 중 하나는 비교 테이블인데, 이는 여러 기능, API 또는 의존성 전반에 걸쳐 프로젝트 버전을 나란히 볼 수 있게 해줍니다. v1.0 이전에는 이 테이블들이 정적인 버전 라벨을 표시하여 프로젝트 버전이 변경되어도 업데이트되지 않았습니다. 이번 수정으로 모든 비교 테이블이 올바른 버전 라벨을 표시하도록 보장하며, 이번 릴리스에서는 기본값으로 v1.0을 사용하고 동적 버전 관리를 위한 기반을 마련했습니다.

문제점

버그는 외관상 문제였지만 방해가 되었습니다. 초기 빌드에서 비교 테이블의 버전 라벨은 템플릿 초기화 시 하드코딩되었습니다. 예를 들어, v0.9에서 테이블을 생성한 후 나중에 v1.0으로 업그레이드해도 출력물에는 여전히 v0.9이 참조되었습니다. 이는 보고서나 문서를 보는 개발자들을 오도했는데, 테이블이 실제 코드베이스나 패키지 메타데이터와 일치하지 않았기 때문입니다. 이 문제는 특히 변경 로그를 위해 자동 비교가 사용되는 CI/CD 파이프라인에서 버전 히스토리를 단편화시켰습니다.

근본 원인은 비교 모듈의 템플릿 엔진에 있는 정적 문자열이었습니다. 프로젝트 버전이 증가해도 버전 필드가 새로 고쳐지지 않아 수동 수정이나 외부 버전 관리 도구에 의존해야 했습니다.

수정 사항