Rotifer가 도메인 레지스트리와 버전 체인 도입으로 50개 유전자 생태계의 네임스페이스 단편화와 버전 추적 문제 해결

Context

유전자 생태계가 50개를 넘으면서 인프라 격차가 드러났다. 개발자들이 기능적으로 동일한 카테고리를 ai.video, media.video, video.generation 같이 서로 다른 도메인명으로 등록했다. 이전 버전과 최신 버전 간 링크가 없어 버전 간 관계를 추적할 수 없었다.

Technical Solution

• 도메인 레지스트리 도입: 로컬 캐시에서 기존 도메인 목록을 제시하고 CLI 대화형 선택을 통해 등록, 클라우드 레지스트리와 자동 동기화
• 도메인 검증 규칙 추가: 소문자 알파벳·숫자·점만 허용 (a-z0-9.), 특수문자와 경로 탐색 차단
• 버전 체인 구현: 새 버전 발행 시 이전 버전의 ID를 previous_version_id 필드에 자동으로 연결
• 변경 로그 저장: rotifer publish 명령어에 --changelog 파라미터 추가 (최대 500자), 미입력 시 자동 diff 생성
• MCP 서버에 list_gene_versions 엔드포인트 추가: 특정 유전자의 전체 버전 히스토리 및 변경 로그 조회 가능
• MCP 호출 분석 계측: 도구명, 성공/실패, 레이턴시, 유전자 ID를 비동기 로깅 (응답 레이턴시 영향 없음)
• get_mcp_stats 도구 신규 추가: 7일/30일 전체 호출 건수, 성공률, 도구별 평균 레이턴시, 상위 도구/유전자 통계 제공
• 도메인 캐시 자동 동기화: rotifer publish와 rotifer install 실행 후 ~/.rotifer/domain_registry.json 자동 갱신
• Windows 로그인 수정: rotifer login이 URL을 윈도우 제목이 아닌 URI로 올바르게 처리
• 유전자 목록 중복 제거 (v0.7.6): search_genes에서 DISTINCT ON (owner_id, name)을 데이터베이스 레벨에서 적용해 최신 버전만 반환

Key Takeaway

생태계가 급속 성장할 때 네임스페이스 표준화와 버전 추적 인프라를 조기에 확립하면 향후 500개 이상의 아티팩트를 효율적으로 관리할 수 있는 토대가 된다. 호출 분석을 fire-and-forget 방식으로 계측하면 시스템 응답성을 유지하면서 생태계 사용 패턴을 정량화할 수 있다.