Gemini CLI v0.68.0: 확장 검증, 평가 테스트

1. 배포 전 로컬 검증 추가

2026년 11월 10일 공개된 v0.68.0 릴리스는 확장 검증 명령과 평가 테스트 추가를 변경 사항으로 소개했다. 연결된 코드 변경은 10월 28일 병합됐다. 이번에 추가된 검사와 단위 테스트, 기능을 작은 단위로 확인하는 검증은 외부 도구를 연결하는 MCP 서버 설정에 집중돼 있다.

검증 대상인 gemini-extension.json은 확장의 이름·버전·연결 정보를 담는 설정 파일인 매니페스트다. 풀 리퀘스트, 코드 변경을 검토받기 위해 올리는 요청, 설명은 함께 읽을 파일의 경로 안전성과 존재 여부, 버전 번호가 정해진 형식에 맞는지도 검사 범위로 제시한다.

2. MCP 서버 설정에서 확인하는 항목

검증기는 서버 설정 묶음인 mcpServers와 각 서버의 설정이 항목 이름과 값으로 이루어진 객체 형태인지 살핀다. 서버를 실행할 명령이나 접속할 주소 등 연결 정보가 적어도 하나 있어야 하며, TCP, 네트워크에서 연결을 설정하는 통신 규약, 연결 값에는 문자열과 숫자를 허용한다.

예전 주소 속성인 httpUrl을 사용하면 오류 대신 경고가 나온다. 안내는 url에 주소를 넣고 연결 유형을 함께 지정하는 방식으로 바꾸도록 권한다.

주소는 URL 형식으로 해석할 수 있는지 확인한다. 환경 변수, 실행 환경에 따라 값이 달라지는 설정값으로 주소를 채우는 설정을 잘못 오류 처리하지 않도록, 달러 기호가 들어간 값은 이 검사를 건너뛴다.

3. 실행과 테스트 범위

풀 리퀘스트 설명에 나온 명령은 다음과 같다. 검사할 확장 폴더의 경로를 인자로 전달해 실행한다.

gemini extensions validate <path>

추가된 테스트는 로컬에서 실행하는 서버와 원격 주소를 쓰는 서버가 검증을 통과하는지 확인한다. 폐기 예정 속성을 쓰는 사례도 경고와 함께 성공하는지 검사해, 설정 변경을 권하는 경고와 실행을 막는 오류를 서로 다르게 다룬다.

연결 정보 누락, 잘못된 주소, 객체가 아닌 mcpServers 값은 실패 사례로 다룬다. 이때 테스트는 오류 메시지와 함께 종료 코드, 프로그램 종료 상태를 숫자로 나타내는 값 1을 확인한다. 개발자에게는 어떤 입력을 거부하고 어떤 입력은 경고만 하는지 보여 주는 구체적인 사례다.

사전 검증의 이익은 설정 문제를 설치나 공개 전에 고칠 수 있다는 점이다. 이 검증을 활용하면 배포 전에 명령을 실행하고 오류를 수정하는 작업이 더해지며, 문제를 찾고 고치는 부담을 개발 단계로 앞당기는 셈이다. 다만 제공된 코드의 주소 검사는 허용할 통신 방식까지 제한하지 않으므로, 접속 주소의 안전성은 별도로 살펴야 한다.

4. 갤러리 색인 문제의 확인법

같은 변경에는 확장 갤러리 색인 문제를 다루는 문서도 추가됐다. 문서는 태그가 붙은 공개 저장소를 갤러리가 매일 살피며, GitHub 코드 검색을 통해 매니페스트 파일을 찾는다고 설명한다. 요구 사항을 충족했는데도 24~48시간 뒤 갤러리에 나타나지 않는다면 GitHub가 아직 파일을 색인하지 않았을 수 있다.

GitHub CLI로 저장소의 매니페스트 검색 결과 수를 확인하는 예시는 다음과 같다.

gh api 'search/code?q=repo:<owner>/<repo>+filename:gemini-extension.json' --jq .total_count

명령의 저장소 자리에는 소유자와 저장소 이름을 넣는다. 검색 결과가 0이거나 GitHub CLI를 쓰지 않는 경우에는 GitHub에 로그인한 브라우저에서 해당 저장소의 코드 검색을 열어 색인을 유도하도록 안내한다.

GitHub가 색인 중이라고 표시하면 15~30분 기다린 뒤 파일이 검색될 때까지 다시 확인한다. 색인이 끝나면 갤러리를 수집하는 프로그램의 다음 실행 주기를 기다리는 절차다. 개발자는 이 검색 결과를 통해 설정 검사와 별개로 파일이 발견될 준비가 됐는지 확인할 수 있다.

v0.68.0의 핵심은 확장 개발자가 배포 전 설정 오류와 배포 후 검색 노출 문제를 각각 점검할 수 있도록 검사와 안내를 구체화한 데 있다.