만약 benchmarking이나 cross-environment comparisons를 위해 vibe-coding-universal을 사용해 오셨다면, 생성된 테이블에서 버전 레이블이 표시되는 방식에 불일치를 발견했을 수 있습니다. 최신 업데이트는 이 문제를 해결했습니다: 비교 테이블은 이제 오래된 버전 레이블 대신

변경 사항은 테이블 렌더링 모듈에 국한되었습니다. 이전에는 버전 레이블 할당이 초기화(initialization) 중에 발생하여 버전 번호가 올라간 후에도 다시 새로 고쳐지지 않았습니다. 이제는 동적입니다: 버전 문자열은 렌더링 시점에 설치된 패키지 메타데이터에서 가져옵니다.

코드 변경 사항

테이블 렌더링 로직에 적용된 핵심 변경 사항의 간소화된 버전을 소개합니다:

# 이전 (캐시된 버전)
class ComparisonTable:
    def __init__(self, metrics):
...

핵심 차이점은 캐시된 버전 속성(cached version attribute)에서 각 렌더링 시점에 가져오는 방식(fetch on each render)으로 이동했다는 것입니다. importlib.metadata.version은 패키징 메타데이터에서 직접 읽기 때문에, 중간 레이블이 아닌 실제 설치된 버전을 반영합니다. 이를 통해 일반적인 사용 사례에서는 오래된 참조(stale references)가 완전히 제거됩니다.

개발자에게 중요한 이유

• 재현성 (Reproducibility): 만약 여러분이 vibe-coding-universal에서 비교 테이블을 공유한다면, 버전 레이블은 이제 환경을 명확하게 식별합니다. 레이블이 실제 코드베이스와 일치하는지 추측할 필요가 없습니다.
• CI/CD 정확도: 자동화된 벤치마킹 파이프라인에서는 종종 결과를 태그하거나 다운스트림 프로세스를 트리거하기 위해 버전 레이블을 사용합니다. 잘못된 레이블은 그 체인을 끊어버립니다. 이 수정 사항은 이러한 통합을 신뢰할 수 있게 유지합니다.
• 최소한의 오버헤드: 변경 사항은 성능에 미미한 영향을 미칩니다—메타데이터 조회는 벤치마크 자체와 비교했을 때 저렴합니다. 유일한 트레이드오프는 테이블이 이제 패키지가 표준적인 방식으로(pip, wheel 등) 설치되어야 한다는 것이지만, 이는 이미 예상되는 배포 방식입니다.

이는 숙련된 개발자들이 높이 평가하는 종류의 수정 사항입니다: 복잡성을 추가하지 않으면서 미묘하고 명백하지 않은 오류의 원인을 제거합니다.

더 큰 그림 (The Bigger Picture)

더 큰 그림 (The Bigger Picture)

vibe-coding-universal은 크로스 버전 비교에서 투명성이 필요한 개발자를 위해 구축되었습니다. 이번 업데이트는 이 목표에 맞춰 도구의 출력을 조정합니다. 만약 성능 보고서나 회귀 감지(regression detection)를 위해 비교 테이블을 사용한다면, 최신 릴리스를 받아 버전 레이블에 의존하는 모든 테이블을 다시 구성해야 합니다. 이제 'v1.0' 태그는 더 이상 오래된 캐싱의 산물이 아니라 진실의 원천입니다.

이 수정 외에도 프로젝트는 최소한의 설정과 예측 가능한 출력을 강조하고 있습니다. 추가적인 렌더링 옵션이나 메트릭 플러그인에 대한 향후 업데이트를 주시해 주세요.