fix(ast-grep): add validation for incomplete function declaration patterns

[code-yeongyu]

Summary

• ast_grep_search에서 불완전한 함수 선언 패턴(export async function $METHOD)이 조용히 실패하는 문제 수정
• 불완전 패턴 검증 함수(validatePatternForCli) 추가
• 친절한 에러 메시지와 올바른 패턴 예시 제공

Problem

LLM 에이전트가 ast_grep_search [pattern=export async function $METHOD, lang=typescript] 패턴을 사용할 때 결과가 없거나 애매한 에러가 발생했습니다.

원인: ast-grep은 완전한 AST 노드만 매칭 가능하며, export async function $METHOD는 파라미터와 바디가 없어 불완전한 패턴입니다.

Solution

1. validatePatternForCli 함수 추가: JS/TS 언어에서 불완전한 함수 선언 패턴 감지
2. 에러 메시지 개선: 올바른 패턴 예시 포함
3. 도구 description 업데이트: "완전한 AST 노드 필요" 명시

Changes

• src/tools/ast-grep/tools.ts: 패턴 검증 로직 및 description 업데이트 (+45 lines)

Testing

• TypeScript typecheck 통과
• Oracle 코드 리뷰 완료

Correct Pattern Examples

// ❌ Incomplete - will now show helpful error
"export async function $METHOD"

// ✅ Correct
"export async function $NAME($$$) { $$$ }"
"function $NAME($$$) { $$$ }"
"async function $NAME($$$) { $$$ }"