근로자 안내 실패를 HR 검토로 안전하게 전환

[hywznn]

왜 필요한가요?

대표 발화문 응웬반A 재계약하고 체류연장 준비해줘에서 대상 이름이 응웬반A 재계약하고로 잘못 추출되어 Server가 TARGET_NOT_FOUND를 반환했습니다.

또한 Language Assistant가 구성되지 않거나 실패해도 Renewal Graph가 내부 Slot 키를 포함한 임시 문장을 근로자에게 보낼 수 있는 WAITING_WORKER 응답으로 만들고 있었습니다.

무엇이 바뀌나요?

• 재계약 행동어 앞에서 근로자 이름 추출을 종료합니다.
• Language Assistant 미구성·호출 실패·HR 검토 필요 결과를 REVIEW_REQUIRED로 전환합니다.
• 검증되지 않은 경우 workerRequestMessage=null을 반환합니다.
• guideReviewRequired, guideFailureCode, REVIEW_WORKER_GUIDE를 Server에 전달합니다.
• 내부 Slot·문서 조합 키를 사용자 안내문 fallback에 노출하지 않습니다.

사용자·개발 영향

• 대표 발화로 올바른 근로자 후보를 찾을 수 있습니다.
• 안전한 안내 초안이 준비되지 않으면 자동 발송 단계로 넘어가지 않고 HR 검토 화면에서 멈춥니다.
• 정상 Language Assistant 결과가 있는 기존 흐름은 유지합니다.

검증

• 관련 Agent·API 테스트 54개 통과
• AI core 회귀 테스트 통과(환경 전용 테스트 파일 제외, 3건 skip)
• 변경 파일 Ruff 통과
• 실제 Server → AI Renewal 호출에서 HTTP 200, REVIEW_REQUIRED, guideReviewRequired=true 확인

남은 범위

• 실제 LLM Provider를 연결한 베트남어 안내 품질 확인
• OCR 승인값을 사용한 동일 Task 재개 및 문서 생성 E2E

Refs #42
Refs fowoco/server#10