llm-cli-gateway 2.0.0: 중요한 의미를 갖는 조용한 공급망(Supply-chain) 릴리스
요약
llm-cli-gateway 2.0.0 버전은 공급망 리스크를 줄이기 위해 better-sqlite3 의존성을 제거하고 Node.js 내장 node:sqlite 모듈을 사용하도록 아키텍처를 변경했습니다. 이를 통해 설치 과정에서의 네이티브 모듈 체인 문제를 해결하고 보안성을 강화했습니다.
핵심 포인트
- better-sqlite3 의존성 제거로 공급망 리스크 최소화
- Node.js 내장 node:sqlite 모듈 사용을 위한 Node >=24.4.0 요구
- 읽기 전용 연결에서의 데이터 변조 방지 및 보안 강화
- 단일 어댑터 구조를 통한 지속성 경계 명확화
llm-cli-gateway 2.0.0 버전이 2026년 6월 4일에 출시되었습니다. 이제 npm은 2.0.0을 최신 버전으로 보고하며, 공개 GitHub 릴리스에는 플랫폼 바이너리(binaries), 번들 설치 프로그램(bundled installers), SHA256 체크섬(checksums), 릴리스 매니페스트(release manifest) 및 Sigstore 번들이 포함되어 있습니다.
가장 핵심적인 변화는 간단합니다. 프로덕션 지속성(production persistence)이 더 이상 better-sqlite3에 의존하지 않는다는 점입니다. 이제 게이트웨이는 src/sqlite-driver.ts에 있는 단일 어댑터(adapter)를 통해 Node의 내장 모듈인 node:sqlite를 사용하며, 이러한 단일 아키텍처 변경을 통해 소비자 트리(consumer tree)에서 설치 시 발생하는 일련의 공급망 리스크(supply-chain risk)를 제거했습니다.
이것이 중요한 이유는 최근의 1.17.x 작업이 데이터베이스로서의 SQLite에 관한 것이 아니었기 때문입니다. 그것은 better-sqlite3를 둘러싼 네이티브 모듈(native-module) 설치 경로, 구체적으로 prebuild-install, tar-fs, 그리고 tar-stream 체인에 관한 것이었습니다. 2.0.0 버전에서는 해당 체인을 패치하거나, 우회하거나, 권고 사항(advisory) 뒤에 숨기지 않았습니다. 대신 프로덕션 설치에서 아예 제외되었습니다. 이제 릴리스 검증을 통해 소비자가 설치된 트리에서 better-sqlite3, prebuild-install, tar-stream을 전혀 받지 않음을 보장합니다.
그 대가로 실제적인 중대한 변경 사항(breaking change)이 발생했습니다. 이제 Node >=24.4.0 버전이 필요합니다. 이는 임의적인 결정이 아닙니다. 게이트웨이의 지속성 계층(persistence layer)은 { id: ... }와 같은 일반 객체를 @id SQL 플레이스홀더(placeholder)에 바인딩하는데, Node 24.4는 이 코드가 의존하는 node:sqlite의 기본적인 이름 지정 매개변수(named parameter) 동작이 구현된 시점입니다. 테스트 스위트(test suite)는 해당 동작을 고정하여, 향후 변경 사항이 조용한 지속성 버그로 변하는 대신 명확하게 실패하도록 합니다.
어댑터 자체는 의도적으로 작게 설계되었습니다. 이제 openDatabase, openReadOnly, GatewayDatabase, 그리고 GatewayStatement가 노출되는 영역(surface area)이며, flight-recorder.ts와 job-store.ts는 SQLite에 직접 접근하는 대신 이 영역을 사용합니다. 릴리스 보안 감사(security audit)는 node:sqlite가 어댑터에 의해서만 참조되도록 강제하며, 이를 통해 지속성 경계(persistence boundary)를 명확하고 검토 가능하게 유지합니다.
읽기 전용(read-only) 경로에는 제가 특히 마음에 들어 하는 보안 세부 사항이 하나 있습니다. 이제 queryRequests는 전용 읽기 전용 SQLite 연결을 열기 때문에, 행 변조(row mutations)가 SQLite 엔진 수준에서 SQLITE_READONLY 오류와 함께 실패합니다. 검토 과정에서 한 가지 예외가 발견되었습니다: VACUUM INTO는 읽기 전용 연결에서도 새로운 파일을 생성할 수 있습니다. 이제 어댑터는 주석 접두사가 붙은 형태나 다중 문(multi-statement) 형태를 포함하여, 읽기 전용 연결에서의 VACUUM 및 VACUUM INTO를 거부합니다. 이는 코드상으로는 작아 보이지만 릴리스 선언(release claim)에 있어서는 매우 중요한 종류의 수정입니다. 왜냐하면
그 결과 더욱 깔끔한 배포 스토리(distribution story)가 완성되었습니다. npm 게시물은 GitHub Actions를 통해 출처(provenance)를 증명합니다. GitHub 릴리스 설치 아티팩트(installer artifacts)는 서명됩니다. 프로덕션 의존성 그래프(production dependency graph)는 더 작아졌습니다. 이제 SQLite가 Node 자체에서 제공되기 때문에, 소비자 설치 시 네이티브 SQLite (Native SQLite)가 제거되었습니다. 이번 릴리스는 화려하지는 않지만, 매우 진지한 보안 강화(hardening) 릴리스입니다. 더 적은 가동 부품(moving parts), 더 적은 설치 스크립트(install scripts), 더 좁은 지속성 경계(persistence boundary), 그리고 업그레이드 및 롤백(rollback) 동작에 대한 더 강력한 증거를 갖추게 되었습니다.
링크:
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기