검색 도구: Glob & Grep

Glob과 Grep는 둘 다 ripgrep 기반이지만 하는 일은 다릅니다. Glob은 파일 경로 집합을 찾고, Grep는 파일 내용 안에서 정규식 일치를 찾습니다. 두 도구 모두 속도만이 아니라 안전한 기본값을 중요하게 둡니다.

GlobTool은 별도 JavaScript glob 라이브러리보다 ripgrep의 파일 워커를 직접 활용합니다. 그래서 대형 저장소에서도 디렉터리 순회가 빠르고, ignore 규칙과 플랫폼별 경계 사례도 한 경로에서 처리할 수 있습니다.

절대 경로 패턴 분해

절대 경로로 들어온 glob은 먼저 검색 시작 디렉터리와 상대 패턴으로 나뉩니다. 이렇게 해야 ripgrep이 저장소 전체를 걷지 않고 더 좁은 위치에서 출발할 수 있습니다.

// /src/utils/*.ts
searchDir: /src/utils
globPattern: *.ts

// ripgrep은 searchDir 아래에서만 탐색

현재 페이지의 기존 설명은 .gitignore 하나만 언급했지만, 실제 기본 동작은 더 넓습니다. ripgrep은 기본적으로 ignore 파일 계층과 숨김 파일 정책을 반영하며, 도구는 여기에 VCS 디렉터리 제외를 더해 불필요한 탐색을 줄입니다.

기본 ignore 스택

• VCS ignore: .gitignore 같은 버전 관리 ignore 규칙
• 추가 ignore 파일: .ignore, .rgignore 같은 ripgrep 규칙 파일
• 숨김 파일 기본 제외: 명시적으로 열지 않으면 숨김 경로는 기본 탐색 대상이 아닙니다

VCS 디렉터리 자체 제외

도구는 검색 대상에서 .git/ 같은 VCS 디렉터리를 실질적으로 배제해 잡음을 줄입니다. 사용자는 보통 버전 관리 메타데이터 안이 아니라 작업 파일 안을 찾고 싶기 때문입니다.

# 개념적 검색 범위
workspace files
  - VCS metadata directories
  - ignored paths from ignore files
  - most hidden paths unless explicitly requested

GrepTool은 같은 검색 엔진 위에서 세 가지 응답 형태를 제공합니다. 모델이 파일 목록만 원하는지, 실제 줄 내용을 원하는지, 빈도를 보고 싶은지에 따라 결과를 바꿉니다.

정렬: 경로만 반환하는 모드에서는 수정 시간이 최근인 파일이 앞쪽으로 오도록 정렬되어, 방금 바뀐 코드가 먼저 눈에 띄게 합니다.

GrepTool의 include는 단순 문자열 붙이기가 아닙니다. shell에 넘겨 확장시키지 않고, 도구 내부에서 glob 패턴으로 해석한 뒤 ripgrep 인수로 안전하게 전달합니다. 덕분에 brace 패턴이나 확장자 묶음도 일관되게 다룰 수 있습니다.

왜 파싱 단계가 필요한가

• shell 확장 방지: 쉘이 먼저 풀어버리면 플랫폼과 실행 환경에 따라 결과가 달라집니다
• 패턴 검증: 빈 패턴이나 이상한 경계를 초기에 걸러낼 수 있습니다
• 동일 동작 보장: GlobTool과 GrepTool이 비슷한 glob 의미 체계를 공유합니다

# 사용 예
include: "*.{ts,tsx}"

# 개념적 처리
parse include glob
  -> normalize pattern
  -> pass as ripgrep glob argument

패턴이 -foo처럼 하이픈으로 시작하면 CLI 도구는 이를 옵션으로 오해할 수 있습니다. 검색 도구는 glob이나 include 패턴을 ripgrep에 넘길 때 이런 입력이 플래그로 해석되지 않도록 안전하게 감쌉니다.

어떤 문제가 생기나

• 옵션 오인: 사용자가 찾으려는 실제 문자열이 새 플래그처럼 보일 수 있습니다
• 플랫폼 차이: 쉘과 프로세스 실행 방식에 따라 오동작 양상이 달라질 수 있습니다
• 보안과 정확성: 패턴은 데이터이지 옵션이 아니므로 경계를 분명히 해야 합니다

# 안전한 개념
ripgrep args: [ ..., "--glob", pattern ]

# 필요할 때는 옵션 종료 경계도 사용
ripgrep args: [ ..., "--", pattern ]

대규모 결과는 그대로 전부 돌려주지 않습니다. GrepTool은 결과를 모은 뒤 offset과 head_limit을 적용해 필요한 창만 잘라 보냅니다.

• 기본 head_limit: 250
• head_limit=0: 명시적으로 제한을 풀겠다는 뜻
• appliedLimit: 실제 절단이 발생했을 때만 응답에 남겨 모델이 불완전 결과임을 알 수 있게 함

// 개념적 슬라이싱
results
  .slice(offset)
  .slice(0, effectiveLimit)

ripgrep 해석은 단순히 "시스템에 있으면 쓰고 없으면 끝"이 아닙니다. 도구는 안정적으로 같은 동작을 보장하기 위해 배포물에 포함된 vendored ripgrep를 사용할 수 있고, 그 결과를 캐시해 반복 해석 비용을 줄입니다.

vendored ripgrep의 의미

• 배포물 동봉: 플랫폼별로 준비된 ripgrep 실행 파일을 함께 가져갈 수 있습니다
• 환경 차이 축소: 사용자 PATH 상태나 시스템 패키지 버전에 덜 흔들립니다
• 해석 결과 캐시: 세션마다 반복 탐색하지 않습니다

이전 설명처럼 특정 번들러에 "내장된 embedded binary"로만 이해하면 좁습니다. 핵심은 런타임이 안정적으로 찾을 수 있는 vendored 실행 파일 경로를 확보하는 것입니다.

검색 결과는 보통 작업 디렉터리 기준 상대 경로로 줄여 토큰을 아낍니다. 하지만 모든 경로에 무조건 상대 경로화를 적용할 수는 없습니다. Windows UNC 경로나 다른 루트에 있는 경로는 잘못 줄이면 오히려 망가질 수 있기 때문입니다.

UNC 경로 보호

• 네트워크 경로 보존: \\server\share\... 같은 경로는 의미를 유지해야 합니다
• 다른 루트 회피: 현재 작업 디렉터리와 다른 드라이브나 루트에 있는 경로는 상대화하지 않을 수 있습니다
• 깨진 경로 방지: 상대화 결과가 원래보다 덜 안전하면 절대 경로를 유지합니다

# 상대 경로화를 시도하되
candidate = relative(cwd, path)

# UNC나 다른 루트라면 원본을 유지
if unsafeRelative(candidate):
  use original path

검색 도구는 빠르기만 해서는 안 됩니다. 긴 줄, huge result set, 느린 파일시스템, 스레드 자원 부족 같은 현실적인 문제를 함께 다뤄야 합니다.

• 타임아웃: 환경에 따라 기본 시간 제한을 두고 hung process를 정리합니다
• EAGAIN 재시도: 자원이 부족하면 더 낮은 병렬성으로 다시 시도합니다
• 줄 길이 제한: 미니파이 파일의 초장문이 응답을 잡아먹지 않게 막습니다
• 경로 상대화 최적화: 최종적으로 돌려줄 후보에만 적용해 문자열 작업을 줄입니다