fix(intent): Knowledge A.X 프롬프트와 PLAN 결정 계약 통합

[hywznn]

배경

Knowledge 원본 A.X 프롬프트를 실제 추론 경로에 적용하고, PLAN에서 결정한 대표 Intent/Workflow를 ANALYZE에서 재분류 없이 재사용합니다.

리뷰 과정에서 같은 Intent의 Workflow 오선택, OUT_OF_SCOPE 종료 계약, 첫 요청 cold start, Renewal 실행의 Server Task Workflow 보존까지 범위를 확장했습니다.

확정 계약

PLAN
→ Intent 모델 1회 호출
→ 대표 Intent + canonical Workflow 결정

Server
→ PLAN 결과와 confidence 이력 보관
→ plannedIntent/plannedWorkflowId를 ANALYZE에 전달

ANALYZE
→ Intent 모델 호출 없음
→ PLAN 결정 재사용
→ Slot만 검사

• Analyses contractVersion=1.1.0
• A.X: confidence=null, confidenceSource=UNAVAILABLE
• BERT routing score: bertRoutingScore로 별도 반환
• ANALYZE Candidate: confidence=null, providerAttemptCount=0
• Candidate workflowId는 plannedWorkflowId와 일치
• MVP에서는 복합 배열 대신 대표 Intent/Workflow 한 건 반환
• evidence를 가짜 extracted Slot으로 만들지 않음
• OUT_OF_SCOPE는 context와 Workflow가 없는 terminal outcome
• Renewal run은 이미 생성된 Server Task의 task.workflowId를 보존

완료 체크리스트

• Knowledge A.X 원본 프롬프트와 Prompt version 적용
• A.X 출력 검증 및 BERT fallback
• PLAN Intent/Workflow 결정을 ANALYZE에서 재사용
• A.X confidence와 BERT routing score 분리
• 같은 Intent의 canonical Workflow 선택 보완
• OUT_OF_SCOPE terminal outcome 및 계약 1.1.0
• BERT/A.X startup warmup, load lock, readiness
• Docker intent-ax 의존성 설치
• Server #138 PLAN/ANALYZE 및 OUT_OF_SCOPE 계약 반영·CI 확인
• Server #131 Renewal Task/Workflow canonical pair 반영
• AI 단위·계약·전체 테스트 및 로컬 실모델 smoke
• 배포 환경 readiness에서 axAvailable=true 확인
• Server #138과 PLAN→ANALYZE / PLAN→OUT_OF_SCOPE 통합 smoke
• Server #131과 Renewal RECONTRACT/WF-CON-001, STAY_PERIOD_EXTENSION/WF-STY-001 통합 smoke

완료 조건

• modelVersion=AX, promptVersion=knowledge-25e778ad
• ANALYZE에서 Intent 모델 재호출 없음
• A.X 결과에 BERT 점수를 confidence로 표시하지 않음
• Renewal 실행에서 정상 업무의 Server Task Workflow가 변경되지 않음
• 관련 단위·API·실모델 smoke test 통과

구현 PR: #33

[hywznn]

후속 계약 정리 커밋: d2a325c

• PLAN 응답을 대표 detectedIntent/workflowId/evidence 1건으로 고정
• A.X confidence=null, confidenceSource=UNAVAILABLE, bertRoutingScore 분리
• ANALYZE는 plannedIntent/plannedWorkflowId를 필수로 받고 Intent 모델 0회 호출
• 복합 Intent 배열과 evidence 가짜 Slot 제거
• Server #138과 contractVersion=1.0.0 및 wire field 일치
• 수정 범위 Ruff, 계약 테스트 39개, PowerShell 전용 OCR smoke 제외 전체 테스트, 로컬 오프라인 BERT+A.X PLAN→ANALYZE 실추론 통과

대기: Server #138은 BERT PLAN confidence를 ANALYZE wire로 보내지 않으면서 Candidate에 같은 점수를 요구하고 있습니다. AI는 재분류·점수 생성을 하지 않고 Candidate confidence=null을 유지하므로 BERT 경계 정책을 Server에서 확정한 뒤 실제 배포 smoke를 진행해야 합니다.

[hywznn]

BERT confidence 정책 확정 반영: 8d776e8

• PLAN BERT confidence/confidenceSource/bertRoutingScore는 Server 실행 이력에만 보존
• ANALYZE wire는 plannedIntent/plannedWorkflowId만 전달
• AI는 재분류하지 않고 Candidate confidence=null, providerAttemptCount=0 반환
• Server는 PLAN confidence 동일성 비교를 제거하고 Candidate confidence nullable 허용
• Candidate workflowId와 plannedWorkflowId 일치는 계속 강제

AI 구현은 이미 이 정책과 일치하며 계약 테스트도 통과했습니다. 남은 작업은 Server #138 반영·병합 후 배포 환경 PLAN→ANALYZE smoke입니다.

[hywznn]

상태 갱신합니다. 이전 댓글의 contractVersion=1.0.0 및 “Server #138 반영 대기” 내용은 현재 기준으로 대체되었습니다.

• 최종 Analyses 계약: 1.1.0
• Server #138: PLAN/ANALYZE 재사용과 OUT_OF_SCOPE 정상 종료 반영, CI 통과 확인
• Server #131: Task/Workflow canonical pair 반영, CI 통과 확인
• AI fix(intent): Knowledge A.X 프롬프트와 PLAN 재사용 계약 통합 #33: Renewal 실행에서 Server task.workflowId를 보존하도록 35d92fa 추가 반영
• AI 검증: 관련 51개, PowerShell OCR smoke 제외 전체 615개 통과

현재 코드 차원의 작업은 완료됐습니다. 남은 항목은 PR #33 체크리스트에 적은 배포 readiness와 Server #138·#131 실제 통합 smoke입니다.

상세 변경 설명: #33 (comment)