검색 절차

탐색 검색

첫 검색은 표제어와 기본 inflection, smart 경계를 사용합니다. 결과가 없으면 --boundary any로 구조 경계를 풀고, 품사 중의성이 예상되면 --pos를 명시합니다.

탐색 단계에서는 파일 확장자보다 directory 범위를 먼저 제한합니다. 결과 surface와 주변 문맥을 확인한 뒤 query를 바꿉니다.

정밀 검색

정밀 검색은 atom 품사 태그, 구 순서와 --max-gap을 고정합니다. Literal 문자열이 목적이면 형태 생성을 끄는 --literal을 사용합니다.

구조로 구분할 수 없는 의미 중의성은 검색기가 제거하지 않습니다. 해당 후보는 주변 code나 문장 문맥에서 판정합니다.

자동화

에이전트와 script는 --json 또는 native CLI의 JSON Lines 출력을 사용합니다. Match가 없는 정상 결과와 실행 오류를 종료 코드로 구분하고 stdout만 parser에 전달합니다.

kfind --pos verb --boundary any --json 걷다 src   | jq -c 'select(.surface != null)'