2.7 KiB
2.7 KiB
Workflow Core
목표
Plane 통신 토대와 별도 pipeline 설계가 정리된 뒤 실제 상태 변화를 기준으로 task 상태 전이를 정리하고 enqueue / running / completed / failed 흐름을 안정화한다. retry, timeout, notification event의 기본 구조를 추가해 core workflow의 운영 기준을 만든다.
단계
Workflow Core
상태
계획
구현 잠금
- 상태: 잠금
- 이유: Workflow Core는 후속 계획 Milestone이며, task lifecycle, retry, timeout, notification event의 책임 경계와 검증 기준이 아직 구현 가능한 수준으로 구체화되지 않았다.
- 해제 조건:
- Work Item Provider Pipeline Design에서 넘길 상태 변화와 실패 케이스가 확정됨
- NomadCode workflow retry/timeout과 IOP 실행 정책의 경계가 문서화됨
- task lifecycle 상태 모델과 notification event 발행 기준이 문서화됨
- 사용자가 이 Milestone의 구현 구체화와 잠금 해제를 명시적으로 승인함
- 잠금 중 금지:
- 코드 구현 또는
agent-task구현 계획 생성 - API/DB/package/file 구조를 추측해 확정
- 세부 구현 체크리스트를 완료 기준처럼 작성
- 코드 구현 또는
범위
- task 상태 전이 정리
- enqueue / running / completed / failed 흐름 안정화
- retry / timeout 기본 구조 추가
- notification event 구조 정리
- Plane 통신 토대와 후속 pipeline 설계에서 확인된 상태 변화와 실패 케이스 반영
필수 기능
- [lifecycle-model] task lifecycle 상태 모델 점검
- [transition-ownership] scheduler와 workflow service의 상태 전이 책임 정리
- [failure-policy] 실패 task 처리 기준
- [retry-timeout] retry와 timeout의 최소 정책
- [notification-model] notification event 모델과 발행 지점
완료 기준
- task가 enqueue 이후 running, completed, failed 상태로 일관되게 전이된다.
- 실패와 timeout이 관찰 가능한 상태로 남는다.
- retry 정책의 최소 동작 방식이 구현되거나 명확히 문서화된다.
- notification event가 workflow 상태 변화와 연결된다.
범위 제외
- 실제 외부 협업 도구로 notification 발송
- 복잡한 workflow DSL
- 고급 권한 정책
- multi-tenant 운영 정책
작업 컨텍스트
- 이전 출처:
services/core/README.md의## 단계별 다음 작업 - 주요 작업 영역:
services/core/internal/workflow/,services/core/internal/scheduler/,services/core/internal/notification/ - 선행 작업: Plane Communication Foundation, Work Item Provider Pipeline Design
- 후속 작업: External Integration
- 검증 기준: scheduler, persistence, adapter behavior를 크게 바꾸면 관련 테스트를 함께 갱신한다.