Skip to content

feat: Knowledge 0.3.0 Workflow·Slot 계약 반영 - #52

Merged
hywznn merged 1 commit into
mainfrom
agent/51-knowledge-0.3-contract
Aug 16, 2026
Merged

feat: Knowledge 0.3.0 Workflow·Slot 계약 반영#52
hywznn merged 1 commit into
mainfrom
agent/51-knowledge-0.3-contract

Conversation

@hywznn

@hywznn hywznn commented Aug 16, 2026

Copy link
Copy Markdown
Member

왜 필요한가요?

Knowledge PR #52가 병합되어 0.3.0이 Intent·Workflow·Slot 계약의 기준이 되었습니다. AI Runtime의 내장 fallback과 응답 버전도 같은 기준을 사용해야 Server가 PLAN 결과를 안전하게 조회·보충할 수 있습니다.

Closes #51

무엇이 바뀌나요?

  • 실제 Knowledge manifest 버전을 contextPackVersion, workflowCatalogVersion에 기록합니다.
  • WF-STY-001의 필수 Slot을 worker_id, due_at으로 맞춥니다.
  • stay_expiry_date, passport_status, arc_status는 PLAN에서 조회하되, 누락만으로 실행을 막지 않는 선택 Context로 분리합니다.
  • 다른 Workflow의 내장 필수 Slot도 Knowledge 0.3.0 계약과 맞춥니다.
  • passport_status, arc_status 예시는 MISSING | SUBMITTED | VERIFIED 상태값만 사용합니다.
  • E2E-011은 AI가 대표 WF-STY-001 한 건을 반환하고, Server가 Knowledge 매핑으로 후속 Workflow를 확장하는 기존 MVP 경계를 유지합니다.
  • 계약 문서와 JSON 예시를 0.3.0으로 갱신합니다.

검증

  • Knowledge 0.3.0 패키지를 직접 연결한 PLAN·ANALYZE 관련 테스트 65개 통과
  • macOS에서 Qdrant Client 1.19.0을 설치하고 관련 테스트 15개 통과
  • macOS에서 PowerShell 7.6.5를 설치하고 OCR 스크립트 테스트 2개 통과
  • 선택 환경 테스트를 포함한 전체 pytest 631개 통과
  • 변경 Python 파일 Ruff 통과
  • Python compileall 통과
  • 변경 JSON 예시 파싱 통과
  • git diff --check 통과
  • DB·Flyway 변경 없음

영향 범위

  • AI PLAN·ANALYZE 계약과 문서만 변경합니다.
  • Server·Client DB 스키마 변경은 없습니다.
  • 열린 Document Automation PR #36의 파일 범위와 직접 겹치지 않습니다.

@hywznn
hywznn marked this pull request as ready for review August 16, 2026 01:36
@hywznn
hywznn merged commit c103494 into main Aug 16, 2026
@hywznn
hywznn deleted the agent/51-knowledge-0.3-contract branch August 18, 2026 08:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

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

1 participant