Skip to content

feat(knowledge): Knowledge 0.3.0 Workflow·Slot 계약 반영 #51

Description

@hywznn

배경

fowoco/knowledge#52가 병합되어 Knowledge 0.3.0이 Intent·Workflow·Slot 계약의 기준이 되었습니다.

현재 AI Runtime은 응답 버전과 내장 Workflow fallback에서 0.2.0 계약을 사용하고 있어, Server가 0.3.0으로 전환하기 전에 AI 소비 계약을 먼저 맞춰야 합니다.

작업 범위

  • DEFAULT_KNOWLEDGE_VERSION0.3.0으로 변경
  • WF-STY-001 필수 Slot을 worker_id, due_at으로 정렬
  • stay_expiry_date, passport_status, arc_status를 선택·Context 조회 Slot으로 분리
  • PLAN 응답의 contextPackVersion, workflowCatalogVersion에 실제 Knowledge 버전 반환
  • Knowledge E2E-011 기준 회귀 테스트 추가
  • 계약 문서와 JSON 예시를 0.3.0으로 갱신

계약 원칙

  • passport_status, arc_status에는 MISSING | SUBMITTED | VERIFIED 상태만 사용
  • 여권번호·외국인등록번호 원문을 상태 Slot에 포함하지 않음
  • due_at이 없으면 HR 입력이 필요한 누락정보로 반환
  • PLAN에서 선택한 대표 Intent·Workflow 결정은 ANALYZE에서 재사용
  • AI가 Server DB에 직접 접근하지 않음

완료 조건

  • PLAN·ANALYZE 계약 테스트 통과
  • 응답 버전 0.3.0 검증
  • E2E-011의 EXPIRY_RENEWAL 대표 흐름 회귀 검증
  • macOS 전체 pytest 631개·변경 파일 Ruff 통과
  • Qdrant 선택 의존성 테스트 15개 통과
  • PowerShell OCR 스크립트 테스트 2개 통과
  • DB·Flyway 변경 없음

기준

Metadata

Metadata

Assignees

Labels

area:integrationServer·Knowledge·Provider 간 계약 경계area:knowledgeKnowledge Catalog·Workflow·Slot 계약area:workflowRenewal Graph·Supervisor·State 재개status:in-progress담당자가 작업을 진행 중type:feature사용자 또는 Agent 기능 개발

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions