feat: Knowledge 0.3 Workflow·Slot 계약 반영

[hywznn]

왜 필요한가요?

Closes #188

AI PR fowoco/ai#52가 Knowledge 0.3.0 계약을 사용하기 시작했지만, Server의 Workflow Projection과 Runtime Fixture는 0.2.0에 머물러 있었습니다. 이 상태에서는 AI 응답이 정상이어도 Server가 버전 불일치로 거부할 수 있습니다.

또한 실제 Server ↔ AI 왕복 검증에서 Knowledge의 due_at이 2026-08-31T18:00:00+09:00처럼 시간대가 포함된 ISO 8601 일시로 반환되자, 날짜만 허용하던 Server가 Candidate 채택을 422로 거부하는 문제를 확인했습니다.

무엇이 바뀌나요?

• Server Workflow Catalog Projection과 Demo Seed 기준 버전을 0.3.0으로 갱신했습니다.
• WF-STY-001의 필수 Slot을 worker_id, due_at으로 검증합니다.
• stay_expiry_date, passport_status, arc_status는 선택 Context로 유지합니다.
• Knowledge 0.3에 없는 WF-INS-001의 과거 Slot quantity, quantity_unit을 Projection에서 제거했습니다.
• due_at의 ISO 8601 일시와 기존 YYYY-MM-DD 형식을 모두 Task due_date로 안전하게 변환합니다.
• Runtime 계약 Fixture, 통합 테스트, AI 계약·Slot Resolver·Demo Seed 문서를 현재 버전에 맞췄습니다.
• Projection이 다시 어긋나지 않도록 WorkflowCatalogProjectionTest를 추가했습니다.

실제 왕복 검증

병합된 AI #52와 로컬 Server를 연결해 아래 흐름을 확인했습니다.

PLAN → NEEDS_INFO(due_at) → 답변 제출 → ANALYZE → REVIEW_REQUIRED → Candidate 채택 → Case·Task 생성

확인 항목	결과
Intent	EXPIRY_RENEWAL
Workflow	WF-STY-001
Knowledge/Catalog version	0.3.0
Slot 답변	due_at=2026-08-31T18:00:00+09:00
저장 결과	due_date=2026-08-31
업무 생성	Case 1건, Task 4건

생성된 Task는 RECONTRACT, STAY_PERIOD_EXTENSION, EMPLOYMENT_PERIOD_EXTENSION, DOCUMENT_REQUEST입니다.

테스트

• ./gradlew test
• Workflow Projection·AiRun·Slot Resolution·Task Workflow 관련 테스트
• 병합된 AI #52와 실제 PLAN → ANALYZE → Candidate 채택 왕복
• git diff --check

충돌 영향

• Flyway Migration과 DB Schema 변경 없음
• 문서 미리보기, 파일 저장, 프로필, RLS 영역 변경 없음
• 기존 Client의 날짜-only 요청도 계속 허용

참고

이번 실제 AI 왕복은 계약과 오케스트레이션 검증을 위한 고정 Intent fallback 환경에서 수행했습니다. 실모델 성능 검증은 별도 Staging E2E 범위입니다.