[AI Integration][P0] Renewal 근로자 안내 REVIEW_REQUIRED 계약 수용

[hywznn]

배경

AI #44는 Language Assistant 미구성·호출 실패·대상 언어 검토 필요 시 근로자용 placeholder를 만들지 않고 다음처럼 fail-closed 반환합니다.

{
  "scenario": "ask_worker",
  "status": "READY_FOR_REVIEW",
  "outcome": "REVIEW_REQUIRED",
  "workerRequestMessage": null,
  "guideReviewRequired": true,
  "guideFailureCode": "LANGUAGE_ASSISTANT_NOT_CONFIGURED",
  "caseSignals": ["REVIEW_WORKER_GUIDE"]
}

현재 Server origin/main은 이 응답을 그대로 수용하지 못합니다.

• RenewalRunResponse에 신규 guide 필드 없음
• RenewalRuntimeContractValidator.CASE_SIGNALS에 REVIEW_WORKER_GUIDE 없음
• scenario=ask_worker이면 항상 workerRequestMessage 비어 있지 않아야 한다고 검증
• 결과 적용부가 Agent의 안내 검토 상태를 Task/업무 메타데이터에 별도로 보존하지 않음

따라서 AI #44는 이 Server 계약이 들어오기 전에는 병합/배포하면 안 됩니다.

Server 작업

• RenewalRunResponse에 guideReviewRequired, guideFailureCode 추가
• failure code 길이·문자 allow-list 검증
• REVIEW_WORKER_GUIDE를 허용 Case Signal에 추가
• ask_worker 정상 경로 검증
  • guideReviewRequired=false
  • workerRequestMessage 비어 있지 않음
  • 기존 Worker 안내 초안 저장 가능
• ask_worker 검토 경로 검증
  • guideReviewRequired=true
  • outcome=REVIEW_REQUIRED
  • status=READY_FOR_REVIEW
  • workerRequestMessage=null
  • caseSignals에 REVIEW_WORKER_GUIDE
  • 자동 WorkerLink/SMS/안내 초안 확정 금지
• guideFailureCode와 검토 필요 상태를 renewal_execution 메타데이터·감사 로그에 보존
• HR이 안내를 검토·수정한 뒤에만 기존 승인/WorkerLink 발급 흐름 진행
• 정상 안내·미구성·Provider 예외·번역 failed·warning 계약 테스트
• AI feat: 사업장 회원가입과 초기 관리자 계정 생성 구현 #44 브랜치와 Server 실제 HTTP smoke

상태 전이 주의

현재 RenewalExecutionResultApplier는 Agent 응답의 status/outcome을 그대로 Task 상태로 적용하지 않고 Slot·체크리스트와 critical fingerprint로 상태를 계산합니다.

안내 검토가 필요한 경우 NEEDS_INFO로 잘못 회귀하거나 DocumentRequestDraft를 저장하지 않도록, Server가 사용할 실제 HR 검토 상태와 다음 행동을 명시적으로 결정해야 합니다. 자동 발송과 자동 승인은 금지합니다.

완료 조건

• AI #44의 fail-closed 응답이 Runtime validator를 통과
• Worker 안내 초안·WorkerLink·SMS가 자동 생성/발송되지 않음
• HR 화면에서 안내 실패 사유와 검토 행동을 확인 가능
• HR 검토 후에만 근로자 안내 흐름 재개
• 기존 정상 WAITING_WORKER 경로 회귀 없음

Refs fowoco/ai#44
Refs fowoco/ai#42